Sign in

v1

latestOpenAPI 3.1.02026-07-2652038.3 KB
API v1
Entities

Search Entities

Find real-world entities by name with fuzzy matching — spans many domains and keeps growing: business (companies, investors, funding rounds, M&A, industries, products), people, legal (laws, regulations, sanctions), geography (countries, places), finance/macro (financial metrics, macro indicators, FX rates), and more — treat this list as illustrative, not exhaustive. Use for "look up X" / "who/what is X" / "X's profile, properties, or relationships" when you know (or partially know) the name. Optionally filter by entity type.

Returns an array of matching entities with IDs that feed entity_retrieval (entity data) and entity_introspection (available fields).

Examples:

{"name": "OpenAI"}

{"name": "Elon Musk", "entity_types": ["Person"]}

{"name": "Berlin", "entity_types": ["GPE"]}

{"name": "GDPR", "entity_types": ["Law"]}

Use this when: You know the name and want the entity ID or a quick profile. Use knowledge_query instead for attribute-based filtering without a name.

get/v1/entities

Query parameters

namestring required

Entity name to search for

Entity name to search for

entity_typesstring[]

Filter by entity types

Filter by entity types

limitinteger

Maximum number of results

Maximum number of results

Response

Successful Response

Example response

{
  "entities": [
    {
      "description": "An American multinational technology company.",
      "entity_type": "Company",
      "id": "e5bb591a-d308-4aa5-9672-96046d366cde",
      "name": "OpenAI"
    }
  ]
}