Search entities
Find a person, company, or knowledge graph entity by free-text query — a name, partial name, nickname, stock ticker, @handle, or website domain. Returns the best matches ranked by relevance, each tagged with a match_quality so you can tell an exact identification from a fuzzy guess. Use it to turn what a user typed into a specific entity — for example before creating an alert to watch it for podcast mentions. Unlike a knowledge graph entity, a result's top-level type may be person, company, or knowledge_graph_entity; pass its id or slug to the matching resource endpoint (/v1/people, /v1/companies, /v1/entities), or its id to alert creation.
Request
- Base URL: https://api.particle.pro
- URL: https://api.particle.pro/v1/entities/search
- Auth: one of:
- API key in header X-API-Key
- HTTP bearer
Query parameters
Results per page
Opaque pagination cursor from previous response
Free-text query: a name, partial name, nickname, stock ticker, @handle, or website domain (e.g. 'sam altman', 'coca cola', 'AAPL', '@sama', 'apple.com').
Restrict results to one kind. Omit to search people, companies, and knowledge graph entities together.
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.