Skip to main content
GET
cURL

Authorizations

X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Query Parameters

entity_id
string

Entity slug (e.g., 'sam-altman') or ID. Required when company_id is not set.

company_id
string

Company slug, domain, or ID. Required when entity_id is not set. Resolves to the company's linked entity.

podcast_id
string

Restrict to mentions inside one podcast.

publisher_id
string

Restrict to mentions on podcasts attributed to one publisher (network), by slug or ID.

role
enum<string>

Constrain how the entity participates: guest, host, panelist, correspondent, or mention.

Available options:
guest,
host,
panelist,
correspondent,
mention
include_ads
boolean

Mentions inside ad reads (sponsor ad segments, or lines spoken by an advertiser) are excluded by default. Pass true to include them.

published_after
string

Only episodes published on or after this date. Omit to aggregate all time.

Example:

"2026-01-01"

published_before
string

Only episodes published on or before this date. Defaults to now.

Example:

"2026-06-01"

interval
enum<string>
default:week

Bucket width.

Available options:
day,
week,
month

Response

OK

buckets
object[] | null
required

Contiguous zero-filled buckets in ascending order

distinct_podcasts
integer<int64>
required

Distinct podcasts those episodes aired on

interval
enum<string>
required

Bucket width

Available options:
day,
week,
month
total_episodes
integer<int64>
required

Episodes with at least one counted mention in the range

total_mentions
integer<int64>
required

Counted mention lines across those episodes

company
object

The resolved company, when company_id was used

end
string

UTC date of the range's exclusive upper bound. When the bound falls inside a day, such as the default of now, mentions on this date up to the bound are still counted.

entity
object

The resolved entity the counts are for

start
string

Start of the first bucket as a UTC date