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

Company identifiers plus optional field selection and exact_match. Provide exactly one identifier type (names, domains, crustdata_company_ids, or professional_network_profile_urls); each may contain one or more values.

names
string[] | null
required
domains
string[] | null
crustdata_company_ids
integer[] | null
professional_network_profile_urls
string[] | null
fields
string[]

Field groups to include in company_data. 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, reviews, public_launches, market_intel, metadata, crustdata_company_id, updated_at, indexed_at. 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[]
Example:
[
{
"matched_on": "mintlify.com",
"match_type": "domain",
"matches": []
}
]