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

# company_search

> Find, look up and enrich companies. Free preview, then 1 credit per full record.

Find buyer accounts by industry, size and HQ geography. Lists match any value; different filters combine with AND. Pass the returned domains or IDs to [`person_search`](https://docs.enricho.co/tools/person-search) to find people there.

> [!NOTE]
>
> **Preview** is a free, unpaginated sample of up to 10, without exact totals. Its `full_search` field suggests a paid full search from the beginning, after you authorize it. Use `next_page` only when you want more; `null` means there's no next page. Follow-up calls are never automatic.

## Parameters

**preview** `boolean`

Free unpaginated sample of up to 10, without exact totals. Ignores `limit`. `has_more` may be true without a cursor; use `full_search` only after authorization.

**industry** `string | string[]`

Part of the industry.

**employee\_size\_band** `string | string[]`

Sizes from `1-10` up to `10001+`.

**country\_code** `string | string[]`

Headquarters countries, ISO 3166-1 alpha-2.

**domain** `string | string[]`

Exact domains, e.g. `"stripe.com"`; a list enriches many companies at once.

**name** `string | string[]`

Part of the company name.

**company\_id** `string | string[]`

Known company IDs.

**query** `string`

Plain words; each must appear in the name, domain, website, industry, country or address.

**exclude\_company\_ids** `string[]`

Leave out these companies in a full search. Preview rejects company-ID exclusions.

**limit** `integer` (default: 20)

Full-page size, 1–100. Preview ignores this and samples up to 10.

**cursor** `string`

Full results only: use `next_page.arguments` unchanged. Restart without a cursor when targeting changes.

## Full-record output

**Identity and business**

`company_id`, `name`, `domain`, `website`, `industry`, `employee_size_band`, `employee_count_min`, `employee_count_max`.

**HQ and contacts**

`country`, `country_code`, `address`, `phone`, `linkedin_url`, `x_url`, `facebook_url`.

**extras / updated\_at**

Custom imported fields as a string-valued map, plus the record update timestamp. Empty or null values mean not on file.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.