Skip to main content
POST
Insights

Credits and plans

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

When to use Insights

  • Check how many contacts have the details you need before paying to retrieve them.
  • Compare audience composition or freshness while adjusting a filter.
  • Measure how often selected fields are populated.
Insights analyzes the filtered audience, rather than the rows in a View or Preview sample. It returns aggregate counts without revealing contact details.

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

These section names are case-sensitive. Each call returns one section. The example reports email availability across the filtered US audience, without returning the addresses.

Options and limits

Freshness uses a 60-day email target and a 90-day profile target. nonNull counts available timestamps; withinSla counts those within the target. Read the returned buckets when comparing age ranges. Coverage groups seniority as C-Team, VP, Director, Manager, Staff, and Other. Other fields show the eight largest groups and can combine the rest as Other. This is a summary, not an exhaustive list of every value in a large vocabulary. For fillRate, calculate populated / total when total is greater than zero. The response supplies counts, rather than percentages.

Errors and retries

An unsupported section returns 400. Correct invalid fields or filters before retrying 400 or 422. Contact and company routes share the default 10 requests per second per user. Wait for the reset time or Retry-After when rate limited; coordinate requests across your workers and API keys.

Next steps

Inspect a free masked View, retrieve a bounded Preview, or estimate an export. Company-only analysis uses Company Insights.

Authorizations

X-Key
string
header
required

Body

application/json
section
string
required

One case-sensitive section: reachability, freshness, coverage, or fillRate.

filter
GroupNode · object | null

Audience filter shared with Count and View. Omitted or null analyzes all contact rows.

fields
string[] | null

For fillRate, up to 12 recognized distinct fields. An empty usable selection returns an empty list.

groupField
string | null

For coverage, a supported field. Defaults to JOB_LEVEL_PER.

Response

Successful Response

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