Skip to main content
GET
cURL

Authorizations

X-API-Key
string
header
required

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

Path Parameters

id
string
required

Company slug (e.g. 'apple'), domain (e.g. 'apple.com'), or ID

Query Parameters

limit
integer<int64>
default:25

Results per page

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

Opaque pagination cursor from previous response

sponsor_id
string

Optional sponsor ID. Selects placements attributed to this sponsor while preserving co-sponsors in the response.

podcast_id
string

Optional podcast ID, slug, or Apple/iTunes collection ID

since
string

Only include ads from episodes published on or after this ISO 8601 date or date-time

Example:

"2025-01-01T00:00:00Z"

until
string

Only include ads before this ISO 8601 date-time. A bare date includes that whole UTC day.

Example:

"2026-01-01"

Response

OK

data
object[] | null
required

List of results

has_more
boolean
required

Whether more results exist

cursor
string

Pass to next request for more results