> ## 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 Autocomplete

> Learn how to discover valid field values for Company Search filters using the Company Autocomplete API.

**Use this when** you need to discover valid filter values before building a
Company Search query — for example, finding the exact industry label or
country code the API expects.

The Company Autocomplete API helps you discover the exact field values the
indexed Company Search API expects. Use it before you build filters for
industries, geographies, company types, funding stages, and more.

Every request goes to the same endpoint:

```
POST https://api.crustdata.com/company/search/autocomplete
```

<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>

### Request fields

| Field     | Type    | Required | Description                                                                                                                                  |
| --------- | ------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `field`   | string  | Yes      | Searchable company field to autocomplete, such as `basic_info.industries`, `taxonomy.professional_network_industry`, or `locations.country`. |
| `query`   | string  | Yes      | Partial text to match. Use `""` to get the most common values.                                                                               |
| `limit`   | integer | No       | Maximum suggestions to return. Default: `20`. Max: `100`.                                                                                    |
| `filters` | object  | No       | Optional condition or nested `and`/`or` group to narrow the suggestion pool.                                                                 |

### Response body

| Field                 | Type   | Description                                                                  |
| --------------------- | ------ | ---------------------------------------------------------------------------- |
| `suggestions`         | array  | Matching values sorted by relevance (or by frequency when `query` is empty). |
| `suggestions[].value` | string | The exact field value to reuse in a Company Search filter.                   |

### Rate limits and pricing

<Callout icon="gift" color="#16a34a">
  <strong>Pricing:</strong> <code>Free</code>.
</Callout>

* **Rate limits:** For current plan-specific limits, see
  [Rate limits](/general/rate-limits).

<CardGroup cols={2}>
  <Card title="Examples" icon="list-filter" href="/company-docs/autocomplete/examples">
    Autocomplete names, most common values, filtered suggestions, and the
    Autocomplete → Search workflow.
  </Card>

  <Card title="Reference" icon="book" href="/company-docs/autocomplete/reference">
    Supported fields, filter operators, errors, API summary.
  </Card>
</CardGroup>

***

## When to use autocomplete

Use this endpoint when you want to:

* Build filter dropdowns or typeahead inputs in your product.
* Validate the exact values a Company Search filter expects.
* Explore the dataset vocabulary for a field before writing search queries.

***

## Your first autocomplete request: discover industry values

Start with the field you want to query and a partial search string. Here,
`tech` returns matching values from `basic_info.industries`.

<CodeGroup>
  ```bash Request theme={"theme":"vitesse-black"}
  curl --request POST \
  	--url https://api.crustdata.com/company/search/autocomplete \
  	--header 'authorization: Bearer YOUR_API_KEY' \
  	--header 'content-type: application/json' \
  	--header 'x-api-version: 2025-11-01' \
  	--data '{
  		"field": "basic_info.industries",
  		"query": "tech",
  		"limit": 5
  	}'
  ```

  ```json Response theme={"theme":"vitesse-black"}
  {
      "suggestions": [
          { "value": "Technology, Information and Media" },
          { "value": "Technology, Information and Internet" },
          { "value": "Information Technology & Services" },
          { "value": "Technical and Vocational Training" },
          { "value": "Space Research and Technology" }
      ]
  }
  ```
</CodeGroup>

### Understanding the response

Autocomplete returns an object with one key:

* **`suggestions`** — an array of matching values, sorted by relevance. Each suggestion contains:
  * **`value`** — the exact field value to reuse in a Company Search filter.

Use the returned `value` exactly as-is in your next search request. This
avoids empty results caused by typos, casing differences, or unsupported
variants.

When `query` is non-empty, suggestions are ranked by match relevance. When
`query` is an empty string, suggestions are ranked by frequency.

***

## What to do next

* **Try more patterns** — see [Examples](/company-docs/autocomplete/examples) for company-name autocomplete, most-common values, and filtered suggestions.
* **Look up supported fields and operators** — see [Autocomplete reference](/company-docs/autocomplete/reference).
* **Use values in a search** — head to [Company Search](/company-docs/search/introduction) once you've picked a value.
* **Enrich a company** — use [Company Enrich](/company-docs/enrichment/introduction) after you find a company.