Search

Changed on Nov 5, 2026

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

Base URL
https://api.cala.ai
Auth
API key in header X-API-KEY

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"
      ]
    }
  ]
}

Changes

Nov 5, 2026e1f2f3a871c8 Revision changes
- warning
  added the new CuratedFinancialMetric enum value to the /// response property for the response status
Nov 3, 202609e738aec7f1 Revision changes
- warning
  removed the optional property from the response with the status
- warning
  added the new AbstractFinancialMetric enum value to the /// response property for the response status
- warning
  added the new Anatomy enum value to the /// response property for the response status
- warning
  added the new Antibody enum value to the /// response property for the response status
- warning
  added the new AntibodyDrug enum value to the /// response property for the response status
- warning
  added the new Archaeon enum value to the /// response property for the response status
- warning
  added the new Bacterium enum value to the /// response property for the response status
- warning
  added the new CellTherapy enum value to the /// response property for the response status
- warning
  added the new ChemicalSubstance enum value to the /// response property for the response status
- warning
  added the new ChemicalSubstanceDrug enum value to the /// response property for the response status
- warning
  added the new Chromosome enum value to the /// response property for the response status
- warning
  added the new ClinicalIntervention enum value to the /// response property for the response status
- warning
  added the new ClinicalOutcome enum value to the /// response property for the response status
- warning
  added the new ClinicalTrial enum value to the /// response property for the response status
- warning
  added the new ClinicalTrialArm enum value to the /// response property for the response status
- warning
  added the new CulturalInstitution enum value to the /// response property for the response status
- warning
  added the new Disease enum value to the /// response property for the response status
- warning
  added the new Document enum value to the /// response property for the response status
- warning
  added the new DomainName enum value to the /// response property for the response status
- warning
  added the new Drug enum value to the /// response property for the response status
- warning
  added the new FundingRound enum value to the /// response property for the response status
- warning
  added the new FundingRoundTranche enum value to the /// response property for the response status
- warning
  added the new Fungus enum value to the /// response property for the response status
- warning
  added the new Gene enum value to the /// response property for the response status
- warning
  added the new GeneTherapy enum value to the /// response property for the response status
- warning
  added the new GovernmentalInstitution enum value to the /// response property for the response status
- warning
  added the new HealthcareEstablishment enum value to the /// response property for the response status
- warning
  added the new HealthcareMetric enum value to the /// response property for the response status
- warning
  added the new HealthcareNetwork enum value to the /// response property for the response status
- warning
  added the new Hospital enum value to the /// response property for the response status
- warning
  added the new LoanFacilityComponent enum value to the /// response property for the response status
- warning
  added the new MechanismOfAction enum value to the /// response property for the response status
- warning
  added the new Medicine enum value to the /// response property for the response status
- warning
  added the new NonprofitOrganization enum value to the /// response property for the response status
- warning
  added the new Oligonucleotide enum value to the /// response property for the response status
- warning
  added the new OligonucleotideDrug enum value to the /// response property for the response status
- warning
  added the new Patent enum value to the /// response property for the response status
- warning
  added the new Pathway enum value to the /// response property for the response status
- warning
  added the new Protein enum value to the /// response property for the response status
- warning
  added the new ProteinComplex enum value to the /// response property for the response status
- warning
  added the new ProteinDrug enum value to the /// response property for the response status
- warning
  added the new ProteinIsoform enum value to the /// response property for the response status
- warning
  added the new Protist enum value to the /// response property for the response status
- warning
  added the new ResearchInstitution enum value to the /// response property for the response status
- warning
  added the new ResearchPaper enum value to the /// response property for the response status
- warning
  added the new SmallMolecule enum value to the /// response property for the response status
- warning
  added the new SmallMoleculeDrug enum value to the /// response property for the response status
- warning
  added the new Transcript enum value to the /// response property for the response status
- warning
  added the new Virus enum value to the /// response property for the response status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status

Operation history