---
title: "Search companies by filters"
method: POST
path: "/api/companies/company-finder"
tags: ["Company Finder"]
---

# Search companies by filters

`POST /api/companies/company-finder`

## Request

- Base URL: `https://quickenrich.io`
- URL: `https://quickenrich.io/api/companies/company-finder`
- Auth: HTTP bearer

Filter-based company search. At least one filter is required. `company_url` supports include only (exclude is rejected).

Constrained dimensions (`country_code`, `number_of_employees`, `revenue`, `services`, `industry`) must use exact lookup values. Charges 1 credit per company returned on the page (unless the account has an unlimited Contact Finder subscription).

Offset `page` pagination is limited to the first 10,000 results. To continue, pass `meta.next_cursor` as `cursor` (page is ignored when cursor is set). Free plans are limited to the first 5 pages and cannot use `cursor`.

## Request body

- CompanyFinderSearchRequest
  - `page` integer: Offset page. Limited to the first 10,000 results. Ignored when `cursor` is set.
  - `per_page` integer
  - `cursor` string: Opaque cursor from `meta.next_cursor`. Use to fetch past the first 10,000 rows. Echo unchanged.
  - `include_full_text` boolean: When true, include full home_page_text on each company.
  - `company_name` IncludeExcludeFilter
    - `include` string[]
    - `exclude` string[]
  - `company_url` object: Include only; exclude is not supported.
    - `include` string[]
  - `city` IncludeExcludeFilter
    - `include` string[]
    - `exclude` string[]
  - `country_code` IncludeExcludeFilter
    - `include` string[]
    - `exclude` string[]
  - `number_of_employees` IncludeExcludeFilter
    - `include` string[]
    - `exclude` string[]
  - `revenue` IncludeExcludeFilter
    - `include` string[]
    - `exclude` string[]
  - `industry` IncludeExcludeFilter
    - `include` string[]
    - `exclude` string[]
  - `services` IncludeExcludeFilter
    - `include` string[]
    - `exclude` string[]
  - `home_page_text` object: Full-text search against homepage content
    - `include` string[]
    - `exclude` string[]
  - `bio_li` object: Full-text search against LinkedIn bio
    - `include` string[]
    - `exclude` string[]

## Response `200`

Companies fetched (may be empty with meta.reason COMPANY_NOT_FOUND).

- object
  - `success` boolean, required
  - `message` string, required
  - `code` integer, required
  - `data` CompanyFinderCompany[]
    - `company_name` string, nullable
    - `url` string, nullable
    - `email_domain` string, nullable
    - `final_email_domain` string, nullable
    - `home_page_email` string, nullable
    - `phone` string, nullable
    - `linkedin_url` string, nullable
    - `city` string, nullable
    - `region_code` string, nullable
    - `country_code` string, nullable
    - `industry` string, nullable
    - `employee_count` string, nullable
    - `revenue` string, nullable
    - `services` string[]
    - `service_count` integer
    - `home_page_text_snippet` string, nullable
    - `bio_li_snippet` string, nullable
    - `home_page_text` string, nullable: Only present when include_full_text=true
  - `meta` object
    - `page` integer
    - `per_page` integer
    - `total` integer
    - `last_page` integer
    - `credits_used` integer
    - `remaining_credits` integer
    - `next_cursor` string, nullable: Opaque cursor for the next page. Null when there are no more results. Pass this value as `cursor` to continue past the first 10,000 rows.
    - `has_more` boolean: True when more results can be fetched via `cursor`.
    - `max_pages` integer: Present on Free plans. Contact Finder and Company Finder search is limited to this many pages (5). Cursor pagination is not available.
    - `reason` string

## Other responses

- `401`: Missing, invalid, or inactive API key
- `402`: Insufficient credits
- `422`: Validation failed
- `429`: Rate limit exceeded
- `500`: Upstream/search service error

---

[API](https://skmtc.dev/quickenrich/apis/quick-enrich-api.md) - [All operations](https://skmtc.dev/quickenrich/apis/quick-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/quickenrich/apis/quick-enrich-api/revisions/581bb7f6ae10?raw)