Sign in

v1

latestOpenAPI 3.1.02026-07-2652038.3 KB
API v1
Knowledge

Search

Search verified knowledge and get back a sourced, prose answer. Best when you have a question and want a researched narrative with citations — not a list of entities.

Returns markdown content with explainability, source citations, and matching entities.

Input can be natural language or Dot-Notation Syntax — both work the same here, only the output shape differs from knowledge_query.

Dot-Notation Syntax lets you express filters and structure directly:

  • . navigates entity/topic → attribute → nested facet (e.g. companies.industry)

  • = != > < >= <= filter a facet

  • AND / OR combine multiple values of the same field (e.g. investors=A AND B, series=A OR B); chain different fields with .

  • order_by=field ASC|DESC and limit=N steer which results surface, not just their order

  • return(f1, f2, ...) focuses the answer on specific fields (a strict field projection on knowledge_query)

  • Clauses can appear in any order

  • Numeric fields may come back as approximate strings (e.g. "over 100M", "~206,753") — synthesize, don't treat as exact

Examples:

{"input": "Who founded Anthropic and what is their background?"}

{"input": "people.role=CEO.company.industry=renewable_energy"}

{"input": "What regulations affect fintech companies in the EU?"}

Use this when: You want a sourced, prose answer to a question. NOT for: A structured list of matching entities — use knowledge_query instead (same input, different output). NOT for: Looking up one specific entity by name — use entity_search.

post/v1/knowledge/search

Request body

inputstring required

Natural language question or Dot-Notation Syntax (e.g. "companies.industry=fintech.founded_year>=2020"). Dot-Notation Syntax is not a strict grammar — there is no syntax to get wrong. An empty or fallback result means no match, not a syntax error.

explainabilityboolean

Whether to generate explainability for the answer.

return_entitiesboolean

Whether to return the entities identified in the answer.

Example request

{
  "input": "Who founded Anthropic and what is their background?"
}

Response

Successful Response

contentstring required

A succinct answer to the user's input in Markdown format.

Example response

{
  "content": "**Altano Energy (Spain)** — Madrid-based, developing renewable energy projects across Spain. Altano secured €60M Series C in 2025 from M&G Investments and Pioneer Point Partners.",
  "context": [
    {
      "content": "Altano Energy - €60m (Series C, Jul 2025). Develops and operates renewable energy projects across Spain...",
      "id": "732e1954-9538-4fbc-a565-db2f8c07ad4e"
    }
  ],
  "entities": [
    {
      "entity_type": "Company",
      "id": "0abe9580-5abb-46df-9506-5dc784520b69",
      "mentions": [
        "Altano Energy",
        "Altano"
      ],
      "name": "Altano Energy"
    }
  ],
  "explainability": [
    {
      "content": "Altano Energy secured a €60 million Series C round in July 2025 from Pioneer Point Partners and M&G Investments.",
      "references": [
        "f22a1a96-6234-48d7-95c2-8b049f00fdab"
      ]
    }
  ]
}