Skip to main content
GET
Company Stats

Credits and plans

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

When to use Company Stats

Read a dataset-wide summary of company coverage. These totals cover the company dataset used by the Contact and Company APIs.
Company Stats does not accept audience filters. Use Company Count to count matching companies, or Company Insights to measure field coverage within a filtered audience.

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 totals

companies is the number of company records. Optional withDomain, withLinkedinUrl, and withAboutUs report populated company fields. contacts sums contact rows represented by the company dataset. Fields can be omitted when the underlying catalog does not include them. These are whole-dataset totals, with no filter or individual company records. Responses can be cached; X-Cache indicates a cache hit or miss when supplied.

Errors and retries

This GET request has no filter or body. 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 Count measures a filtered audience; Company Insights analyzes its composition and field fill rates.

Authorizations

X-Key
string
header
required

Response

200 - application/json

Successful Response

The response is of type Response Company Stats V1 Company Stats Get · object.