Skip to main content
Use this when you already know the company and want its full profile — for research, scoring, personalization, or diligence. The Company Enrich API takes an identifier you already have — a website domain, a profile URL, a company name, or a Crustdata company ID — and returns a detailed company profile with headcount, funding, industry, hiring, and more. The same endpoint supports both single-company lookups and multi-company requests. Every request goes to the same endpoint: 
POST https://api.crustdata.com/company/enrich
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

ParameterTypeRequiredDefaultDescription
domains / professional_network_profile_urls / names / crustdata_company_idsarrayYes — one only—Submit exactly one identifier type.
fieldsstring[]No["basic_info"]Sections of company_data to include in the response.
exact_matchbooleanNonullSet to true to restrict results to exact primary_domain matches.
Looking for the list of sections you can request? See Valid fields values for the full table of section group names you can pass to fields.

​
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. Empty for no-match inputs.
matches[].confidence_scorenumberHigher is better. 1.0 is common for direct identifier lookups.
matches[].company_dataobjectFull enriched company profile.

​
Rate limits and pricing

Current platform behavior — not specified in the OpenAPI contract:
Pricing: 2 credits per record.
  • Rate limit: 15 requests per minute.
If you only need lightweight discovery, start with Company Search, then enrich the companies you want in full detail.

Identifiers

Enrich by profile URL, name, or company ID. Exact match and multi-company requests.

Reference

Request parameters, response fields, valid fields values, company_data sections, validation, errors.

​
Your first enrichment: look up a company by domain

The simplest enrichment takes a website domain and returns matching company profiles. Pass the domain in the domains array. 
curl --request POST \
  --url https://api.crustdata.com/company/enrich \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --header 'x-api-version: 2025-11-01' \
  --data '{
    "domains": ["retool.com"]
  }'
description in basic_info is truncated in this snippet for readability. Other fields reflect the default response — when fields is omitted, company_data only contains crustdata_company_id and basic_info. Request additional sections such as headcount, funding, or people explicitly via fields (see Using the fields parameter).
The year_founded field is returned as a string. The format may be a full date (e.g., 2017-01-01) or a year string (e.g., 2017) depending on the data source.

​
Understanding the response

The Enrich 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. Possible values: domain, name, crustdata_company_id, professional_network_profile_url.
  • matches — an array of candidate companies. Each match includes a confidence_score and the full company_data object.
Domain lookups may return multiple matches if the domain is ambiguous. The highest confidence_score indicates the best match. Use exact_match: true to restrict results to companies whose primary_domain exactly matches your input (see Identifiers).

​
How to interpret results

  • Multiple matches: If matches contains more than one entry, check confidence_score — the highest score is the best match. Use primary_domain to verify.
  • Empty matches array: The identifier did not match any company. Check for typos or try a different identifier type.
  • confidence_score: Higher is better. A score of 1.0 is common for direct identifier lookups such as profile URLs or company IDs.

​
What to do next

  • Enrich by other identifiers — see Identifiers for profile URL, name, company ID, exact match, and multi-company requests.
  • Look up request/response details and fields — see Enrich reference for request parameters, company_data sections, and valid fields values.
  • Search for companies first — use Company Search to find companies by industry, funding, headcount, and more, then enrich the matches.
  • Discover filter values — use Autocomplete to find valid values before building search filters.