Look up people and companies by external identifier
Resolves external identifiers — LinkedIn slugs, social handles, company domains, stock tickers, SEC CIKs, Wikidata QIDs — to the people and companies that carry them. It is the reverse of GET /v1/people/{slug}/external-links and GET /v1/companies/{id}/external-links. Pass a comma-separated identifier list (up to 100 per call); platform is optional, so a handle with no known source still resolves. A full profile URL works in place of a bare identifier and the platform is inferred from it, and the stored form is matched for you — pass satyanadella or the profile URL, not in/satyanadella.
Each result echoes the input identifier and carries a matches array, because an identifier is not unique to an entity: a LinkedIn profile claimed by two duplicate person records resolves to both, and match_count reports the total. Unresolved identifiers come back with an empty matches, so a bulk caller never has to reconcile a shorter response against a longer request. Correlate by the echoed identifier rather than by position, since duplicate identifiers collapse to one result.
Use GET /v1/entities/search instead when you have a name rather than an identifier, and GET /v1/podcasts/lookup or GET /v1/podcasts/episodes/lookup for podcast and episode identifiers.
Request
- Base URL: https://api.particle.pro
- URL: https://api.particle.pro/v1/entities/lookup
- Auth: one of:
- API key in header X-API-Key
- HTTP bearer
Query parameters
One or more external identifiers to resolve. Pass a comma-separated list to look up many at once (max 100 per call). A full profile URL works in place of a bare identifier and the platform is inferred from it. The identifier is echoed back exactly as supplied, not normalized.
[ "in/satyanadella", "microsoft.com" ]
Restrict the lookup to one platform. Optional — omit it to match the identifier on any platform, which is what you want when you hold a handle but not its source. Accepts any platform reported on the external-links endpoints plus the company identifier namespaces 'domain', 'ticker', 'sec' (CIK) and 'wikidata' (QID).
Restrict results to one kind of entity. Omit to search people and companies together.
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.