---
title: "Get autocomplete suggestions for company search fields"
method: POST
path: "/company/search/autocomplete"
tags: ["Company APIs", "Autocomplete APIs"]
---

# Get autocomplete suggestions for company search fields

`POST /company/search/autocomplete`

Returns field value suggestions with document counts for company search fields.
Useful for discovering valid filter values before building search queries.
Accepts field names from the /company/search response schema using dot notation.

<Note>
    Default `rate-limit` is 45 requests per minute. Send an email to [gtm@crustdata.co](mailto:gtm@crustdata.co) to discuss higher limits if needed for your use case.
</Note>

## Headers

- `x-api-version` '2025-11-01', required

## Request body

- CompanyAutocompleteRequest — Request body for autocomplete suggestions on company search fields.
  - `field` string, required — The dataset API field name to get suggestions for. Valid fields include: basic_info.name, basic_info.primary_domain, basic_info.website, basic_info.professional_network_url, basic_info.professional_network_id, basic_info.company_type, basic_info.year_founded, basic_info.employee_count_range, basic_info.markets, basic_info.industries, revenue.estimated.lower_bound_usd, revenue.estimated.upper_bound_usd, revenue.acquisition_status, funding.total_investment_usd, funding.last_round_type, funding.last_fundraise_date, funding.investors, funding.tracxn_investors, headcount.latest_count, headcount.largest_headcount_country, locations.country, taxonomy.professional_network_industry, taxonomy.professional_network_specialities, taxonomy.categories, followers.latest_count, social_profiles.crunchbase.url, social_profiles.twitter_url, revenue.public_markets.stock_symbols, revenue.public_markets.fiscal_year_end
  - `query` string, required — The search query text (can be empty to get top values by frequency)
  - `limit` integer — Maximum number of suggestions to return
  - `filters` union — Optional filters to narrow down suggestions
    - AutocompleteFilterCondition — A single filter condition to narrow down autocomplete suggestions.
      - `field` string, required — The dataset API field name to filter on
      - `type` '=' | '!=' | '<' | '=<' | '>' | '=>' | 'in' | 'not_in' | 'contains', required
      - `value` union, required — The filter value or list of values
        - string
        - number
        - integer
        - boolean
        - union[]
          - union
            - string
            - number
            - integer
    - AutocompleteFilterConditionGroup — A group of autocomplete filter conditions combined with and/or logic.
      - `op` 'and' | 'or', required
      - `conditions` union[], required
        - union
          - AutocompleteFilterCondition — A single filter condition to narrow down autocomplete suggestions.
            - `field` string, required — The dataset API field name to filter on
            - `type` '=' | '!=' | '<' | '=<' | '>' | '=>' | 'in' | 'not_in' | 'contains', required
            - `value` union, required — The filter value or list of values
              - …
          - AutocompleteFilterConditionGroup — recursive

## Response `200`

Autocomplete suggestions with document counts

- CompanyAutocompleteResponse — Response with autocomplete suggestions for a company search field.
  - `suggestions` CompanyAutocompleteSuggestion[], required
    - `value` string, required — The suggested field value

## Other responses

- `400` — Invalid request (e.g., unsupported field)
- `401` — Unauthorized - invalid or missing API key
- `500` — Internal server error

---

[API](https://skmtc.dev/crustdata/apis/batch-api.md) · [All operations](https://skmtc.dev/crustdata/apis/batch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/crustdata/batch-api/revisions/581689e66ae7/schema)