Skip to content

Individual Ads

POST
/api/public/advertisers/individual-ads

Individual ad rows for one advertiser, same data set as the advertiser page “Individual Ads” download.

Available for Pro users with API access.

Individual Ads
curl --request POST \
--url https://backend.podscribe.ai/api/public/advertisers/individual-ads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "advertiser": "example", "startDate": "example", "endDate": "example", "limit": 500, "offset": 0 }'
Media typeapplication/json
advertiser
required

The advertiser to get individual ads for.

string
startDate

Start date timestamp, e.g., 2023-10-10, default is 24 months ago.

string
endDate

End date timestamp, e.g., 2023-10-10, default is today.

string
limit

Maximum number of rows to return per request.

integer
Default value: 500
Allowed range: (1–1000)
offset

Number of rows to skip; combine with limit to page through all rows.

integer
Default value: 0
Allowed range: (0–1000000)

OK

Media typeapplication/json
headers
required

Columns of the rows in data, in order.

Array<{id,name}>
id
required

Column key in each data row.

Allowed values: published_at download_at network position read_type read_score podcast_title episode_title transcript start_time end_time ad_length genre episode_duration podcast_rank apple_podcast_id product link estimated_impressions estimated_spend media_type podcast_show_id youtube_show_id youtube_video_views episode_url_in_feed show_first_transcribed_at
21 moreLess
name
required

Column name, the same as id.

Allowed values: published_at download_at network position read_type read_score podcast_title episode_title transcript start_time end_time ad_length genre episode_duration podcast_rank apple_podcast_id product link estimated_impressions estimated_spend media_type podcast_show_id youtube_show_id youtube_video_views episode_url_in_feed show_first_transcribed_at
21 moreLess
data
required

One object per ad, holding the columns listed in headers.

Array<{published_at,download_at,network,23 more}>
published_at

Episode publish date (YYYY-mm-DD).

string nullable
download_at

Timestamp when Podscribe downloaded the episode.

string
network

Publisher name.

string nullable
position

Ad position.

string nullable
read_type

Read type.

string nullable
read_score

AI read score.

number nullable
podcast_title

Show title.

string
episode_title

Episode title.

string
transcript

Ad transcript.

string nullable
start_time

Ad start in episode.

string nullable
end_time

Ad end in episode.

string nullable
ad_length

Ad duration.

string nullable
genre

Show categories.

string nullable
episode_duration

Episode duration.

string nullable
podcast_rank

Show average rating.

number nullable
apple_podcast_id

Apple Podcast ID.

string nullable
product

Product name.

string
link

Ad playback link.

string
estimated_impressions

Estimated episode listens; podcast rows only.

number nullable
estimated_spend

Estimated ad spend, $; podcast rows only.

number nullable
media_type

Show platform.

string
podcast_show_id

Podscribe ID of the podcast show; on a YouTube row, the podcast it simulcasts.

number nullable
youtube_show_id

Podscribe ID of the YouTube show; on a podcast row, its YouTube simulcast.

number nullable
youtube_video_views

On a YouTube row, the current public view count of the video the ad ran in; null when unavailable.

number nullable
episode_url_in_feed

Episode URL. YouTube rows link to the YouTube video, podcast rows to the episode audio file from the RSS feed; null for other platforms.

string nullable
show_first_transcribed_at

Date Podscribe first transcribed an episode of the show (YYYY-mm-DD), refreshed daily. Marks when monitoring of the show started, not continuous coverage since then.

string nullable
pagination
required

Paging of this response and the total row count.

{limit,offset,total}
limit
required

Row limit applied to this page.

integer
offset
required

Rows skipped before this page.

integer
total
required

Total rows matching the filters, across all pages.

integer
Response example
{
"headers": [
{
"id": "published_at",
"name": "published_at"
}
],
"data": [
{
"published_at": "2025-01-15",
"download_at": "2025-01-20 13:45",
"network": "Wondery",
"position": "mid",
"read_type": "Host",
"read_score": 94,
"podcast_title": "Example Show",
"episode_title": "Episode 123",
"transcript": "Try acme.com slash pod...",
"start_time": "00:10:25",
"end_time": "00:10:55",
"ad_length": "00:00:30",
"genre": "Business,Investing",
"episode_duration": "00:45:12",
"podcast_rank": 4.7,
"apple_podcast_id": "123456789",
"product": "Premium Plan",
"link": "https://...",
"estimated_impressions": 45000,
"estimated_spend": 1200,
"media_type": "podcast",
"podcast_show_id": 12345,
"youtube_show_id": 67890,
"youtube_video_views": 41250,
"episode_url_in_feed": "https://www.youtube.com/watch?v=EQOzxvLp4qg",
"show_first_transcribed_at": "2026-02-12"
}
],
"pagination": {
"total": 3987
}
}