Skip to main content
POST
Company Count

Credits and plans

PAYG is Pay-as-you-go. AYCE is All-you-can-eat. Company records are deduplicated to one search row per RBID_ORG. If you need company fields alongside individual people, contact records already include their available company data; requesting those fields does not add a separate company-row charge.

When to use Company Count

  • Size a company audience before retrieving rows.
  • Compare company criteria without spending credits.
  • Count distinct companies represented by contacts who meet job or person criteria.

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.

Read the result

Person or job filters select the companies of matching contacts. The returned contact totals still include all contacts at each selected company, not just the contacts matching those conditions. Optional totals are omitted when the dataset lacks them.

Options and limits

Reuse the filter for Company Export. Company Count accepts company and contact criteria. mode is accepted for compatibility with Contact Count but does not change the result: company counts are exact. Omitting filter searches the whole company dataset.

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

Company Preview returns a small inline list using company criteria. For a company list selected by person or job conditions, use Company Estimate and Company Export.

Authorizations

X-Key
string
header
required

Body

application/json
filter
GroupNode · object | null

Company or contact conditions selecting distinct companies. Omitted or null counts the full company dataset.

mode
string
default:fast

Accepted for compatibility; company counts are exact regardless of this setting.

Response

Successful Response

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