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. A person slug or ID resolves via the person's linked knowledge graph entity; a person with no linked entity falls back to name matching (matched_by=name). 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; a company with no linked entity falls back to name matching (matched_by=name).

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.

episode_id
string

Restrict to mentions inside one episode by slug or ID (cross-corpus result still surfaces a single episode group).

role
enum<string>

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

Available options:
guest,
host,
panelist,
correspondent,
mention
sort
enum<string>

Result ordering. recency (the default) returns the most recently published episodes first. popularity orders by the parent podcast's global popularity percentile — the biggest shows first, recency breaking ties within a show, non-charting podcasts last. Pass the same sort alongside a cursor when paginating.

Available options:
recency,
popularity
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.

since
string

Only episodes published after this date.

Example:

"2024-01-01"

until
string

Only episodes published before this date.

Example:

"2024-06-01"

context_lines
integer<int64>
default:2

Surrounding dialogue lines around each mention.

Required range: 0 <= x <= 20
limit
integer<int64>
default:25

Episodes per page (1-100, default 25). Each episode's full set of mention windows is returned in a single page; episodes never split across pages.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from a previous response.

Response

OK

data
object[] | null
required

Episodes on this page, ordered by recency (default) or salience

has_more
boolean
required

More episodes available

company
object

Resolved company, when company_id filtered the result set. Omitted when only entity_id was provided.

cursor
string

Opaque cursor; pass back as ?cursor= for the next page

entity
object

Resolved entity. Omitted on empty pages where neither entity_id nor company_id resolved, and on name-matched pages (see matched_by) where the subject has no knowledge graph entity.

matched_by
string

How mention lines were matched. Omitted for the default knowledge-graph tag matching; 'name' when the subject has no knowledge graph entity and dialogue was scanned for the subject's name verbatim.

person
object

Resolved person, when entity_id resolved to a person with no linked knowledge graph entity (name-match fallback).