Skip to main content
Search for any entity by name: companies, people, products, places, laws, and more. Fuzzy matching included.
  • Allows searching and filtering entities by various criteria
  • Returns a list of matching entities with their ID, type, and a short description
  • Helps agents find relevant entities in the Cala’s Knowledge

​
Example:

{"name":"Tesla"}

Search Results

Returns all matching entities across types — companies, people, products, facilities, and more. Each result includes an id, name, entity_type, and a description when available (null if not).
{
  "entities": [
    {"id": "2f3cb1a7-b8b8-4ef8-a3ae-b5b274d5601d", "name": "Tesla Motors, Inc.", "entity_type": "Company", "description": "A multinational automotive manufacturer and software, hardware, and financial services provider based in Austin, Texas, with over 130,000 employees."},
    {"id": "8d6e0b83-7cf0-4fbf-a6f0-653df0c7ee9d", "name": "Tesla Semi", "entity_type": "Product", "description": null},
    {"id": "5cfa93b1-008e-41ab-8a20-dc112e7fec17", "name": "Nikola Tesla", "entity_type": "Person", "description": "A Serbian who founded Tesla Electric Company."},
    {"id": "f1c4a574-3e14-4d3c-8f8d-95e6d747670f", "name": "1 Tesla Road", "entity_type": "Facility", "description": null},
    {"id": "6f9eebde-824f-49b2-8a89-6de8c419fba8", "name": "Tesoro", "entity_type": "Company", "description": "A logistics firm registered in Wilmington, Delaware and headquartered at Ridgewood Parkway in San Antonio, Texas."}
  ]
}
One search for “Tesla” returns the company, its products, a historical person, and even a facility — all typed and ready to explore.
Narrow results to specific types using the entity_types parameter:
{"name":"Tesla", "entity_types":"Person"}


{
  "entities": [
    {"id": "5cfa93b1-008e-41ab-8a20-dc112e7fec17", "name": "Nikola Tesla", "entity_type": "Person", "description": "A Serbian who founded Tesla Electric Company."}
  ]
}
Available entity types:
TypeDescriptionExamples
GPEGeopolitical entities (countries, cities, states)Spain, San Francisco, Texas
CompanyCompanies & corporationsTesla, OpenAI, Y Combinator
CorporateEventCorporate eventsTesla Q4 2024 Earnings Call
CountrySovereign countriesUnited States, Japan, Brazil
CountryRegionRegions within countriesCalifornia, Bavaria, Tuscany
EducationalInstitutionUniversities & schoolsMIT, Stanford University
FacilityFacilities & buildings1 Tesla Road, Pentagon
IndustryIndustries & sectorsAutomotive, Artificial Intelligence
LanguageLanguagesEnglish, Mandarin
LawLaws & regulationsGDPR, Securities Act of 1933
LocationRegions & geographic areasSouthern Europe, Sahara Desert
OrganizationNon-company organizationsUnited Nations, NATO, FIFA
PersonPeopleNikola Tesla, Sam Altman
ProductProducts & servicesTesla Semi, GPT-4o
WorkOfArtCreative worksThe Great Gatsby, Starry Night
You can pass multiple types: entity_types=Company&entity_types=Person
ParameterTypeRequiredDescription
namestringYesEntity name to search for
entity_typesarrayNoFilter by entity type(s)
limitintegerNoMax results (1–100, default 20)
# Get up to 5 Company results for "Tesla"
curl "https://api.cala.ai/v1/entities?name=Tesla&entity_types=Company&limit=5" \
  -H "X-API-KEY: YOUR_CALA_API_KEY"
Use the returned entity UUIDs with POST /v1/entities/{entity_id} to get full profiles — founders, executives, funding, HQ, and more.