> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crustdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Identify examples

> Identify companies by name, profile URL, or Crustdata company ID with ranked match results.

This page collects examples for
[Company Identify](/company-docs/identify/introduction). Each example is a full working
request you can copy, paste, and adapt.

For the core walkthrough (first identification by domain, response shape,
Identify vs Enrich), see [Company Identify](/company-docs/identify/introduction). For the
request/response schema, validation, and errors, see
[Identify reference](/company-docs/identify/reference).

<Note>
  Replace `YOUR_API_KEY` in each example with your actual API key. All
  requests require the `x-api-version: 2025-11-01` header.
</Note>

***

## Identify by company name

Name-based identification often returns multiple candidates. Check
`confidence_score` and `primary_domain` to pick the right match.

<CodeGroup>
  ```bash Request theme={"theme":"vitesse-black"}
  curl --request POST \
    --url https://api.crustdata.com/company/identify \
    --header 'authorization: Bearer YOUR_API_KEY' \
    --header 'content-type: application/json' \
    --header 'x-api-version: 2025-11-01' \
    --data '{
      "names": ["Serve Robotics"]
    }'
  ```

  ```json Response theme={"theme":"vitesse-black"}
  [
      {
          "matched_on": "Serve Robotics",
          "match_type": "name",
          "matches": [
              {
                  "confidence_score": 1.0,
                  "company_data": {
                      "crustdata_company_id": 628895,
                      "basic_info": {
                          "name": "Serve Robotics",
                          "primary_domain": "serverobotics.com",
                          "employee_count_range": "51-200",
                          "industries": ["Technology, Information and Internet"]
                      }
                  }
              },
              {
                  "confidence_score": 1.0,
                  "company_data": {
                      "crustdata_company_id": 5825197,
                      "basic_info": {
                          "name": "Site Serve Robotics",
                          "primary_domain": "siteserverobotics.co.uk",
                          "employee_count_range": "2-10",
                          "industries": ["Construction"]
                      }
                  }
              }
          ]
      }
  ]
  ```
</CodeGroup>

<Tip>
  When multiple matches are returned, use `primary_domain` and
  `employee_count_range` to disambiguate. The first match is not always the
  right one for name-based lookups.
</Tip>

***

## Identify by profile URL

If you have a company profile URL, pass it in
`professional_network_profile_urls`. Profile URL lookups are direct matches —
they typically return a single match with high confidence.

<CodeGroup>
  ```bash Request theme={"theme":"vitesse-black"}
  curl --request POST \
    --url https://api.crustdata.com/company/identify \
    --header 'authorization: Bearer YOUR_API_KEY' \
    --header 'content-type: application/json' \
    --header 'x-api-version: 2025-11-01' \
    --data '{
      "professional_network_profile_urls": [
        "https://www.linkedin.com/company/mintlify"
      ]
    }'
  ```
</CodeGroup>

***

## Identify by Crustdata company ID

Pass a Crustdata company ID (for example, from a previous search call) to
`crustdata_company_ids` for an exact lookup.

<CodeGroup>
  ```bash Request theme={"theme":"vitesse-black"}
  curl --request POST \
    --url https://api.crustdata.com/company/identify \
    --header 'authorization: Bearer YOUR_API_KEY' \
    --header 'content-type: application/json' \
    --header 'x-api-version: 2025-11-01' \
    --data '{
      "crustdata_company_ids": [628895]
    }'
  ```
</CodeGroup>

Company ID lookups return an exact match.

***

## Common workflow: Inbound domain → Identify → Search for similar companies

An inbound lead arrives from a known domain. Use Identify to resolve the
domain to a company record, then use Search to find similar companies for
prospecting.

### Step 1: Identify the inbound company

<CodeGroup>
  ```bash Request theme={"theme":"vitesse-black"}
  curl --request POST \
    --url https://api.crustdata.com/company/identify \
    --header 'authorization: Bearer YOUR_API_KEY' \
    --header 'content-type: application/json' \
    --header 'x-api-version: 2025-11-01' \
    --data '{"domains": ["retool.com"]}'
  ```

  ```json Response theme={"theme":"vitesse-black"}
  [
      {
          "matched_on": "retool.com",
          "match_type": "domain",
          "matches": [
              {
                  "confidence_score": 1.0,
                  "company_data": {
                      "crustdata_company_id": 633593,
                      "basic_info": {
                          "name": "Retool",
                          "primary_domain": "retool.com",
                          "employee_count_range": "201-500",
                          "industries": ["Software Development"]
                      }
                  }
              }
          ]
      }
  ]
  ```
</CodeGroup>

**Extract:** Take
`response[0].matches[0].company_data.basic_info.industries[0]` →
`"Software Development"` and `employee_count_range` → `"201-500"`.

### Step 2: Search for similar companies

<CodeGroup>
  ```bash Request theme={"theme":"vitesse-black"}
  curl --request POST \
    --url https://api.crustdata.com/company/search \
    --header 'authorization: Bearer YOUR_API_KEY' \
    --header 'content-type: application/json' \
    --header 'x-api-version: 2025-11-01' \
    --data '{
      "filters": {
        "op": "and",
        "conditions": [
          {"field": "basic_info.industries", "type": "in", "value": ["Software Development"]},
          {"field": "headcount.total", "type": ">", "value": 200},
          {"field": "headcount.total", "type": "<", "value": 1000}
        ]
      },
      "sorts": [{"field": "headcount.total", "order": "desc"}],
      "limit": 10,
      "fields": ["crustdata_company_id", "basic_info.name", "basic_info.primary_domain", "headcount.total"]
    }'
  ```

  ```json Response theme={"theme":"vitesse-black"}
  {
      "companies": [
          {
              "crustdata_company_id": 67890,
              "basic_info": { "name": "Retool", "primary_domain": "retool.com" },
              "headcount": { "total": 450 }
          },
          {
              "crustdata_company_id": 12345,
              "basic_info": { "name": "Notion", "primary_domain": "notion.so" },
              "headcount": { "total": 800 }
          }
      ],
      "next_cursor": "H4sIAM_5zGkC...",
      "total_count": 1543
  }
  ```
</CodeGroup>

**Extract:** Take `companies[].crustdata_company_id` values and pass them to
[Enrich](/company-docs/enrichment/introduction) for full profiles of promising matches.

**If empty:** If `companies` is `[]`, broaden your filters (for example,
wider headcount range or more industries). Use
[Autocomplete](/company-docs/autocomplete/introduction) to verify valid filter values.

***

## Next steps

* [Identify reference](/company-docs/identify/reference) — request parameters, validation, errors, API summary.
* [Company Enrich](/company-docs/enrichment/introduction) — pass the `crustdata_company_id` from Identify into Enrich to get the full profile.
* [Company Search](/company-docs/search/introduction) — find similar companies by industry, headcount, or funding.