Skip to main content
Use this when you have partial company information and need to resolve it to a specific Crustdata company record — for CRM deduplication, lead routing, entity resolution, or pre-enrichment matching. The Company Identify API takes an identifier you have — a website domain, a profile URL, a company name, or a Crustdata company ID — and returns one or more matched companies ranked by confidence score. Identify is designed for entity resolution rather than deep profiling.
This page documents the live Identify response directly. Current platform behavior returns match metadata plus company_data.basic_info. If you need the broader company sections used in full profiles, see Enrich reference.
Every request goes to the same endpoint: 
POST https://api.crustdata.com/company/identify
Replace YOUR_API_KEY in each example with your actual API key. All requests require the x-api-version: 2025-11-01 header.

​
Request body

ParameterTypeRequiredDescription
domains / professional_network_profile_urls / names / crustdata_company_idsarrayYes — one onlySubmit exactly one identifier type.
exact_matchbooleanNoSet to true for strict domain matching.

​
Response body

The response is a top-level array. Each entry corresponds to one input identifier.
FieldTypeDescription
matched_onstringThe input identifier you submitted
match_typestringdomain, name, crustdata_company_id, professional_network_profile_url
matchesarrayCandidate matches ranked by relevance. Empty for no-match inputs.
matches[].confidence_scorenumberHigher is better.
matches[].company_dataobjectMatch metadata plus basic_info.

​
Rate limits and pricing

Pricing: Free.
  • Rate limits: For current plan-specific limits, see Rate limits.
Use Identify first when your input is ambiguous. You can resolve the right company for free, then call Enrich only for the records you want in full detail.

Identifiers

Identify by name, profile URL, or Crustdata company ID.

Reference

Request parameters, validation, no-match behavior, errors.

​
Your first identification: look up a company by domain

Pass a website domain in the domains array to find the matching company. 
curl --request POST \
  --url https://api.crustdata.com/company/identify \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --header 'x-api-version: 2025-11-01' \
  --data '{
    "domains": ["serverobotics.com"]
  }'

​
Understanding the response

Current platform behavior: The live Identify endpoint returns a top-level array, not an object with a results wrapper.
The Identify API returns a top-level array — one entry per identifier you submitted. Each entry has three fields:
  • matched_on — the identifier you submitted (the domain, URL, name, or ID).
  • match_type — which identifier type was used. Values: domain, name, crustdata_company_id, professional_network_profile_url.
  • matches — an array of candidate companies ranked by relevance. Each match includes a confidence_score and a company_data object. Current platform behavior returns basic_info here.
For detailed behavior when no identifier matches, see No-match behavior.

​
Identify vs Enrich

IdentifyEnrich
Endpoint/company/identify/company/enrich
PricingFree2 credits per record
ResponseMatch results with company_data.basic_infoFull company profile
Best forMatching, deduplication, entity resolutionResearch, scoring, diligence
Use whenYou need to resolve “which company is this?”You need detailed company data
Common pattern: Use Identify to resolve ambiguous inputs, then pass the crustdata_company_id from the best match into Enrich for the full profile.

​
What to do next

  • Identify by other inputs — see Identifiers for name, profile URL, and company ID examples.
  • Look up request/response details — see Identify reference.
  • Get the full profile — pass the crustdata_company_id from Identify into Enrich for detailed company data.
  • Search for similar companies — use Company Search to find companies matching the same industry or headcount range.