Skip to main content
GET
Autocomplete Companies
Provides autocomplete suggestions for companies based on search text. This endpoint powers company autocomplete dropdowns in the application, helping users quickly find and select companies by name. Results can be sorted by employee count for relevance.

Authentication

This endpoint requires authentication. The user must be signed in to access autocomplete data.
This endpoint proxies requests to the our search metadata API. Results are cached for 7 days to improve performance.

Request

Search query to filter companies by name. Returns companies that match this text. Leave empty to retrieve all companies.
integer
default:"10"
Number of results to return per page. Maximum recommended value is 100.
integer
default:"0"
Zero-based page number for pagination.
string
Sort order for results based on company employee count.Allowed values:
  • asc - Sort by employee count ascending (smallest first)
  • desc - Sort by employee count descending (largest first)

Response

Returns a paginated list of company items matching the search criteria.
CompanyMetadataItem[]
Array of company items matching the query.
integer
Total number of matching companies across all pages.
integer
Total number of pages available.
integer
Number of items per page.
integer
Current page number (zero-based).
boolean
Whether this is the first page.
boolean
Whether this is the last page.
boolean
Whether the result set is empty.
integer
Number of elements in the current page.

Response Examples

Usage Examples

Search for companies by name

Get largest companies first

Paginate through results

Get small companies for SMB targeting

Notes

  • Results are cached for 7 days to improve performance. The cache is shared across all users.
  • Use the search parameter for type-ahead/autocomplete functionality - it filters results that match the company name.
  • The employeeCount sort parameter is useful for targeting specific company sizes (enterprise vs SMB).
  • Company logos are provided via external URLs and may not always be available.
  • The domain field is useful for deduplication and matching companies across different data sources.