Skip to main content
POST
https://api.crustdata.com
/
company
/
enrich
curl --request POST \
  --url https://api.crustdata.com/company/enrich \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "domains": [
    "hubspot.com"
  ],
  "fields": [
    "basic_info",
    "headcount",
    "funding"
  ]
}
'
{
  "results": [
    {
      "matched_on": "https://www.linkedin.com/company/mintlify",
      "match_type": "professional_network_profile_url",
      "matches": [
        {
          "confidence_score": 1,
          "company_data": {
            "basic_info": {
              "name": "Mintlify",
              "primary_domain": "mintlify.link",
              "all_domains": [
                "mintlify.com",
                "mintlify.link"
              ],
              "company_type": "Privately Held",
              "year_founded": "2022-01-01",
              "employee_count_range": "51-200",
              "industries": [
                "Software Development"
              ]
            },
            "revenue": {
              "estimated": {
                "lower_bound_usd": 2500000,
                "upper_bound_usd": 5000000
              }
            }
          }
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token in the Authorization header.

Headers

​
x-api-version
string
required

API version to use. Must match a supported version (e.g., "2025-11-01").

Example:

"2025-11-01"

Body

application/json

Company identifier and optional field selection for enrichment

Request body for enriching, identifying, or fetching company data. Exactly one identifier must be provided: names, domains, crustdata_company_ids, or professional_network_profile_urls.

​
names
string[] | null

Company names to look up

Example:
["Serve Robotics"]
​
domains
string[] | null

Company website domains to look up

Example:
["hubspot.com"]
​
crustdata_company_ids
integer[] | null

Crustdata internal company IDs

Example:
[628895]
​
professional_network_profile_urls
string[] | null

LinkedIn company profile URLs

Example:
["https://www.linkedin.com/company/mintlify"]
​
fields
string[]

Fields to include in the response. Use dot-notation for nested fields. Valid top-level groups for enrich: basic_info, revenue, headcount, funding, hiring, web_traffic, seo, competitors, employee_reviews, people, locations, taxonomy, followers, news, software_reviews, social_profiles, status. Not valid for enrich: roles, skills (search-only fields).

Example:
["basic_info", "headcount", "funding"]
​
exact_match
boolean | null

Whether to use exact matching for domain/name lookup. When null, auto-detects.

Example:

true

Response

Enriched company data

Response from the company enrich or fetch endpoint, containing one result per input identifier.

​
results
object[]

List of enrich results, one per input identifier

Example:
[]