Skip to main content
POST
Company Insights

Credits and plans

PAYG is Pay-as-you-go. AYCE is All-you-can-eat.

When to use Company Insights

Check industry, location, or employee-size distribution before retrieving companies, or find how often the fields you need are populated. Insights analyzes the filtered audience, rather than a Preview sample.

Example

Set REVENUEBASE_API_KEY to your API key.
Response captured from the local test API on October 13, 2026. Results can change as the dataset or account changes.

Choose one section

Use these exact case-sensitive section values. Person reachability and freshness sections are available on Contact Insights. For company contact totals, use Company Count.

Options and limits

  • Use company filters and fields from Company Columns. Person and job filters are unsupported.
  • For coverage, groupField defaults to EMPLOYEE_COUNT_RANGE_ORG. Smaller categories can be combined as Other.
  • For fillRate, provide fields explicitly. The service uses up to 12 recognized, distinct fields; no usable fields produces an empty fillRates list.
  • Calculate a fill percentage as populated / total when total is greater than zero. These are counts, not returned company records.

Errors and retries

Correct unsupported fields or filters before retrying a 400 or 422 response. If a 429 response is returned, wait for Retry-After. Contact and company routes share the default 10 requests per second per user.

Next steps

Retrieve inline companies or estimate a file using the same company filter.

Authorizations

X-Key
string
header
required

Body

application/json
section
enum<string>
required

One case-sensitive section: coverage or fillRate.

Available options:
coverage,
fillRate
filter
GroupNode · object | null

Company conditions only.

fields
string[] | null

For fillRate, up to 12 recognized distinct company fields.

groupField
string | null

For coverage, a company field. Defaults to EMPLOYEE_COUNT_RANGE_ORG.

Response

Successful Response

The response is of type Response Company Insights V1 Company Insights Post · object.