Skip to main content
POST
New Company Finder search
Several filters only accept exact values from a fixed list: industries, technologies, revenue ranges and funding round names. Look them up in Taxonomies. A value that is not in the list silently matches nothing.
Company Finder has no webhook. Retrieve the results by polling GET /company_finder/async/{request_id}.

Filters

  • List filters only take include. Unlike Lead Finder, there is no exclude: it is silently ignored.
  • Unknown keys are silently ignored too, so check the spelling against the reference below. Lead Finder keys such as job_title do not exist here.
  • At least one filter must hold a real value, otherwise the request is refused with 400.
  • company is case-sensitive: send domains in lowercase.

Pagination

limit and offset paginate a single search. offset is zero-based: keep limit constant and step offset by limit on each call. The total number of matching companies is returned as summary.companies_found, so you know how many pages to walk. Each page is a new search and is charged on its own, see Credits.

Authorizations

X-API-Key
string
header
required

Body

application/json

Filters and pagination for the company search

filters
object
required

Company criteria. At least one filter must hold a real value. Unknown keys are ignored, and so is exclude: a request made only of those is refused with 400.

limit
integer
default:100

Number of companies to return for this page, between 1 and 200. Defaults to 100. A value above 200 is refused with 422; 0, a negative number or a non-numeric value falls back to the default.

Required range: 1 <= x <= 200
Example:

100

offset
integer
default:0

Zero-based number of matches to skip. A negative value is treated as 0.

To walk through results, keep limit constant and increase offset by limit on each call. The total number of matching companies is returned as summary.companies_found.

Required range: x >= 0
Example:

0

Response

Company Finder request accepted. Poll GET /company_finder/async/{request_id}.

success
boolean
Example:

true

message
string
Example:

"Company finder request accepted."

request_id
string
Example:

"bc39ffbfc24cf043b748"