Put our AI into your systems

Use the Primer Enterprise API to connect our powerful decision engines to your existing systems and interfaces. Quickly, simply, & securely.

What the Primer Enterprise API can do for you

• Search large corpora of documents to return either the full content or aggregated statistics.
• Freeze scope into Document Sets so all downstream analysis runs on a stable, reproducible set of content.
• Run asynchronous Assets, then poll and retrieve the results
• Narratives & Themes Use lookup to cluster claims into narratives, profile to create concise summaries, graphs to reveal narrative evolution, and themes to group narratives/claims into hierarchical topics and synthesize cross-narrative summaries.
• Entities Lookup and disambiguate entities

Generate cited summaries, surface affiliations and quotes, and map related entities and network connections across documents.

• Targeted Sentiment

Get a stance for each entity (positive, neutral, negative) with pointers to the exact supporting spans of text in each document, optimized for small batch inputs.

• Events & Map extractors

When available, extract activities and points of interest, attach geospatial context for mapping, and include links back to the source document

Key endpoints

Search

Start with Search when you’re still shaping the problem.

• Use POST /v3/search/documents when you need full records (titles, text, metadata) to inspect or pass along.
• Use POST /v3/search/aggregations when you only need counts, facets, and quick "how big/how often" signals to steer filters and UI. Returns no documents, just metrics. If you'll run downstream analyses, freeze scope into a Document Set so later assets operate over a stable, reproducible body of content.

Document Sets

Use a Document Set to freeze the scope so every downstream asset runs over the same content. You can create one in two common ways:

• From search terms — POST /v3/document-sets with a search_request. The response returns a document_set_id you’ll pass to assets.
• From raw text — POST /v3/document-sets with a raw_texts array of strings. Each string is treated as one document in the set. Not all endpoints support raw text, so check the documentation for the individual endpoints.

Why it matters: with a fixed document_set_id, assets are deterministic and auditable, rather than chasing a moving search window.

You can programmatically list your sets later via GET /v3/document-sets and inspect basic metadata (name, created_at).

Narratives and Themes

These endpoints help you move from "a heap of articles" to "what claims are being made, how they group, and how they evolve."

• Narratives — Combine related claims into narrative-level assets with LLM-generated titles, date-aware summaries, citations back to source chunks, and per-entity sentiment so you can inspect how a specific storyline is supported across documents.
• Themes — Automatically cluster extracted claims into narratives and then higher-level themes so you can see the major topics, perspectives, entities, and time ranges that structure a document set.
• Theme Sets — Generate theme-level titles and summaries for curated groups of narratives, reusing their titles and summaries to synthesize an overarching perspective for the cluster you care about, rather than one discovered automatically.

Tip: Treat these as asynchronous assets: create, poll until complete, then fetch results. This keeps calls responsive and lets you orchestrate multiple analyses in parallel.

Entities

Move from "who is this?" to "show me evidence." These endpoints help you discover canonical IDs, build a reusable lookup, and then generate cited facts, affiliations, and quotes over your scoped body of content.

• Find canonical IDs (Knowledge Base search)
  • GET /v3/knowledge-base/entities-search
  • Fuzzy, alias-aware search over the NEL (named entity linking) KB. Filter by entity_types, paginate with 1-based page and page_size (max 100). Results are relevance-ranked.
• Build the foundation (Entity Lookup asset)
  • POST /v3/assets/entity-lookup
  • Creates a comprehensive lookup of entities and sentence-level co-mentions for your Document Set; many downstream entity calculators depend on this asset. Requires document_set_id. Read results with GET /v3/assets/entity-lookup/{asset_id}/results (paginated; up to 1000 items/page) to fetch entities, relationships, and context.
• Summarize with citations (Entity Summary)
  • POST /v3/assets/entity-summary
  • Generates a concise, evidence-linked sentence about an entity (or an entity pair) with structured references. If you don’t pass an entity_lookup_asset_id, one is auto-created.
• Extract affiliations (Entity Affiliations)
  • POST /v3/assets/entity-affiliations
  • Pulls roles/positions/org relationships and returns per-document sentence-level citations. Depends on Entity Lookup (auto-created if missing). Results are paginated (asset results endpoints typically allow large pages, for example, up to 1000).
• Attribute quotes (Entity Quotes)
  • POST /v3/assets/entity-quotes
  • Finds quoted text and attributes it to the target entity, returning document IDs, sentence content, and character spans. Depends on Entity Lookup (auto-created if missing). Read with GET /v3/assets/entity-quotes/{asset_id}/results (paginated).

Targeted Sentiment

• Targeted Sentiment – Analyze up to 20 short documents from a Document Set to extract entities, attach positive / neutral / negative stance labels, and return character spans for each mention, making it easy to rapidly triage per-entity sentiment in inbox-sized batches.
• Targeted Sentiment Counts – Run the same entity-level sentiment analysis but aggregate all positive, neutral, and negative mentions per entity across up to 20 documents, returning grouped spans so you can see not just stance but how often each sentiment occurs.

The technology behind Primer

Primer combines agentic AI, natural language processing, advanced information retrieval, powerful data visualizations, and mission-ready infrastructure to help teams make sense of complex information environments. The platform transforms unstructured data into structured context so mission teams can search, explore, and act on insights with confidence.