Skip to main content
POST
https://api.crustdata.com
/
company
/
professional_network
/
enrich
/
live
curl --request POST \
  --url https://api.crustdata.com/company/professional_network/enrich/live \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "domains": [
    "hubspot.com"
  ],
  "fields": [
    "basic_info",
    "headcount"
  ]
}
'
{
  "results": [
    {
      "matched_on": "hubspot.com",
      "match_type": "domain",
      "matches": [
        {
          "confidence_score": 1,
          "company_data": {
            "basic_info": {
              "name": "HubSpot",
              "primary_domain": "hubspot.com",
              "professional_network_url": "https://www.linkedin.com/company/hubspot"
            },
            "headcount": {
              "total": 11965
            }
          }
        }
      ]
    }
  ]
}

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 real-time fetch

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

Realtime 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:
[]