Skip to main content
POST
https://api.crustdata.com
/
company
/
identify
curl --request POST \
  --url https://api.crustdata.com/company/identify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "domains": [
    "serverobotics.com"
  ]
}
'
{
  "results": [
    {
      "matched_on": "serverobotics.com",
      "match_type": "domain",
      "matches": [
        {
          "confidence_score": 1,
          "company_data": {
            "crustdata_company_id": 628895,
            "basic_info": {
              "crustdata_company_id": 628895,
              "name": "Serve Robotics",
              "primary_domain": "serverobotics.com",
              "all_domains": [
                "serverobotics.com"
              ],
              "website": "https://www.serverobotics.com/",
              "professional_network_url": "https://www.linkedin.com/company/serverobotics",
              "professional_network_id": "72049930",
              "profile_name": "Serve Robotics",
              "employee_count_range": "51-200",
              "industries": [
                "Technology, Information and Internet"
              ]
            }
          }
        }
      ]
    }
  ]
}

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 (exactly one of names, domains, crustdata_company_ids, or professional_network_profile_urls)

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

Identified company data

Response from the company identify endpoint, containing one result per input identifier.

results
object[]

List of identify results, one per input identifier

Example:
[]