Identify People
Resolve up to 25 identifiers to the people behind them in one synchronous request. Send exactly one identifier key: professional_network_profile_urls, emails or research_profile_urls. Profile URLs and Scholar profile URLs match exactly. Each match returns the person’s crustdata_person_id, basic_profile, social_handles and updated_at; for the full profile or contact data, pass the returned profile URL to /person/enrich or /person/contact/enrich.
emails accepts business and personal addresses. An address on file matches exactly. Otherwise Crustdata matches it by the name in the address at the company that owns the domain, when that match is confident enough for the company’s size, and then looks it up with a contact vendor inside the same request; a match on a new address can take a few seconds longer than one already on file.
The response is a top-level array with one row per identifier, in request order. match_status is matched, not_found or redacted; redacted means the person asked Crustdata to remove their data, and that row is never returned and never charged. business_emails is not accepted here; use emails. For lists larger than 25, use /batch/person/identify.
Billing: 1 credit per matched identifier. Unmatched and redacted identifiers are never charged. Identify is enabled per account; without access the request returns 403.
Default rate-limit is 30 requests per minute. Send an email to gtm@crustdata.co to discuss higher limits if needed for your use case.
Authorizations
API key passed as a Bearer token in the Authorization header.
Headers
API version to use. This endpoint currently requires 2025-11-01.
2025-11-01 "2025-11-01"
Body
Exactly one identifier key with up to 25 values.
- Option 1
- Option 2
- Option 3
Exactly one identifier key, up to 25 values. business_emails is rejected; use emails.
Person profile URLs. 1 credit per match.
25Email addresses, business or personal. An address not on file is matched by name at the domain's company, then looked up with a contact vendor, in the same request. 1 credit per match.
25Google Scholar profile URLs, for example https://scholar.google.com/citations?user=VGjeKSMAAAAJ. Only Google Scholar is supported. 1 credit per match.
25Response
One row per submitted identifier, in request order.
The identifier as you sent it.
"abhilash@crustdata.com"
The request key, singular.
professional_network_profile_url, email, research_profile_url Outcome for this identifier. matched: one match, billed. not_found: no person in Crustdata for this identifier; nothing billed. redacted: the person asked Crustdata to remove their data and the request was approved; the row is empty, never billed, and does not change on retry.
matched, not_found, redacted Zero or one match.
1