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"
  ]
}
'

[
  {
    "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",
            "logo_permalink": "https://crustdata-media.s3.us-east-2.amazonaws.com/company/9f84e252d0f9e35c95843303b33eda9313148adb54404d06947be750e9187db5.jpg",
            "description": null,
            "company_type": null,
            "year_founded": null,
            "employee_count_range": "51-200",
            "markets": null,
            "industries": [
              "Technology, Information and Internet",
              "Technology, Information and Media"
            ]
          }
        }
      }
    ]
  }
]

Identify Companies

Match a company by name, website domain, profile URL, or Crustdata company ID. Returns one or more matches ranked by confidence score. This endpoint is useful for entity resolution before enrichment.

Current platform behavior returns a top-level array with one result per submitted identifier. Each match currently includes company_data.crustdata_company_id and company_data.basic_info.

Exactly one identifier type must be provided per request.

Default rate-limit is 15 requests per minute. Send an email to gtm@crustdata.co to discuss higher limits if needed for your use case.

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"
  ]
}
'

[
  {
    "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",
            "logo_permalink": "https://crustdata-media.s3.us-east-2.amazonaws.com/company/9f84e252d0f9e35c95843303b33eda9313148adb54404d06947be750e9187db5.jpg",
            "description": null,
            "company_type": null,
            "year_founded": null,
            "employee_count_range": "51-200",
            "markets": null,
            "industries": [
              "Technology, Information and Internet",
              "Technology, Information and Media"
            ]
          }
        }
      }
    ]
  }
]

Authorizations

Authorization

string

header

required

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

Headers

x-api-version

enum<string>

default:2025-11-01

required

API version to use. This endpoint currently requires 2025-11-01.

Available options:

2025-11-01

Example:

"2025-11-01"

Body

application/json

Company identifier plus optional exact_match for domains. Provide exactly one of names, domains, crustdata_company_ids, or professional_network_profile_urls.

Raw request parameters from query string

names

string[] | null

domains

string[] | null

crustdata_company_ids

integer[] | null

professional_network_profile_urls

string[] | null

fields

string[]

Field groups to include in company_data. Current platform behavior: when fields is omitted, only crustdata_company_id and basic_info are returned — sections such as headcount, funding, people, and hiring must be listed explicitly. Valid field groups for enrich: basic_info, revenue, headcount, funding, hiring, web_traffic, seo, competitors, employee_reviews, people, locations, taxonomy, followers, news, software_reviews, social_profiles. Not valid for enrich: roles, skills (search-only fields).

exact_match

boolean | null

Whether to use exact matching (null means auto-detect)

Response

Identified company matches returned as a top-level array

matched_on

string

The specific input value (e.g., 'google.com')

match_type

enum<string>

Available options:

name,

domain,

crustdata_company_id,

professional_network_profile_url

matches

object[]

Show child attributes

Example:

[
  {
    "matched_on": "mintlify.com",
    "match_type": "domain",
    "matches": []
  }
]

⌘I