Show Info
Episodes, advertisers, downloads and other details of a show.
const url = 'https://backend.podscribe.ai/api/public/series/episodes/example?months=1';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}import requests
url = "https://backend.podscribe.ai/api/public/series/episodes/example"
querystring = {"months":"1"}
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())curl --request GET \ --url 'https://backend.podscribe.ai/api/public/series/episodes/example?months=1' \ --header 'Authorization: Bearer <token>'Path Parameters
Section titled “Path Parameters”ITunes ID / YouTube Channel ID / YouTube Playlist ID
Query Parameters
Section titled “Query Parameters”Zero-based page index. Ignored unless pagination is on (at least one of episodesPageIndex or episodesPageSize is sent). If you send only episodesPageSize, this value is 0.
Episodes per page (max 100). Ignored unless pagination is on (at least one of episodesPageIndex or episodesPageSize is sent). If you send only episodesPageIndex, this value is 25.
Comma-separated advertiser lookup names to compute net new reach for, for example zocdoc. Listeners already exposed to any of the listed advertisers are excluded from the net new reach, so several names behave as a single combined advertiser. Net new reach covers every campaign the advertiser runs, including campaigns booked through other agencies. Each name must be an advertiser the API key has access to, otherwise the request is rejected with 403. At most 10 names are accepted, and at least one is required when the parameter is present. Net new reach is only measured for podcasts, so other shows never carry the field. Without this parameter the response has no netNewReachPercent field.
Size of the listening window used for net new reach, in months. Only applies together with netNewReachAdvertisers.
Response Body
Section titled “Response Body”OK
The unique identifier for a show in the Podscribe platform.
The title of a series of a podcast or other audio content.
The platform the show is published on, for example Podcast or YouTube.
The estimated number of listeners each month who download at least one episode of the podcast (does not include YouTube viewers).
The total estimated number of downloads the show receives across all episodes each month.
The average estimated number of downloads episodes receive within the first 60 days from publish date. Useful for estimating delivery for episodic buys.
The average estimated number of views episodes receive within the first 60 days from publish date (includes only YouTube). Useful for estimating delivery for episodic buys.
The total estimated number of views the show receives across all episodes each month.
The average estimated number of Spotify downloads episodes receive within the first 60 days from publish date. Useful for estimating delivery for episodic buys.
The total estimated number of Spotify downloads the show receives across all episodes each month.
The average estimated number of Rumble downloads episodes receive within the first 60 days from publish date. Useful for estimating delivery for episodic buys.
The total estimated number of Rumble downloads the show receives across all episodes each month.
The total estimated number of podcast downloads the show receives across all episodes each month.
The average estimated number of podcast downloads episodes receive within the first 60 days from publish date. Useful for estimating delivery for episodic buys.
The percentage of ads found in the last 6 months that are direct response, i.e. not branding ads. We determine an ad to be “direct response” if it has a clear measurable action, such as visiting a URL, downloading an app, etc., from which the advertiser is most likely determining campaign success.
The percentage of the ads read by the host.
The total number of ads in Podscribe across all episodes of a show.
The names of up to 25 advertisers with the most ads on the show, most ads first.
Up to 50 podcast shows similar to this show, sorted by contentSimilarity (descending). Empty for non-podcast shows.
Array<{seriesId,title,contentSimilarity,4 more}>
The unique identifier for a show in the Podscribe platform.
The title of the similar podcast show.
Content topic similarity score between the reference show and this show.
Audience similarity based on TransUnion demographic data.
Audience similarity based on social media data.
Percentage of the reference show’s audience that also listens to this show.
Percentage of this show’s audience that also listens to the reference show.
The percentage of all ads on this show that have a subsequent ad in an episode published in the following 2 months. This is a proxy to indicate whether an advertiser buys again on this show. Episodes in the most recent 2 months are ignored when calculating this rate.
The show’s ad load, as a percentage.
The ad load of the show’s YouTube simulcast, as a percentage.
Whether the Podscribe prefix has been placed on the show.
Spotify Video opt-in date, ISO 8601 date-time.
The show’s Twitter / X link, when known.
The show’s Facebook link, when known.
The show’s Instagram link, when known.
The show’s YouTube link, when known.
The show’s TikTok link, when known.
The number of Twitter / X followers for the show, when known.
The number of Facebook followers for the show, when known.
The number of Instagram followers for the show, when known.
The number of YouTube subscribers for the show, when known.
The number of TikTok followers for the show, when known.
The show’s content risk scores, overall and by category.
{seriesId,overallScore,scoreByCategory}
The unique identifier for a show in the Podscribe platform.
The overall content risk score.
A breakdown of the content risk scores by category.
The show’s most recent episodes, newest first; one page of them when pagination is on.
Array<{title,podscribeEpisodeId,description,22 more}>
The title of an episode of a podcast or other audio content.
The unique identifier for an episode in the Podscribe platform.
The first 100 characters of the description of an episode of a podcast or other audio content.
The number of total downloads of an episode. audio content.
The number of total downloads of an episode for first 30 days after publishing.
The number of total downloads of an episode for first 7 days after publishing.
The number of downloads of an episode for podcast.
The number of downloads of an episode for first 30 days after publishing.
The number of downloads of an episode for first 7 days after publishing.
The number of Youtube downloads of an episode for YouTube.
The number of Youtube downloads of an episode for first 30 days after publishing.
The number of Youtube downloads of an episode for first 7 days after publishing.
The number of Spotify downloads of an episode for Spotify.
The number of Spotify downloads of an episode for first 30 days after publishing.
The number of Spotify downloads of an episode for first 7 days after publishing.
The number of Rumble downloads of an episode for Rumble.
The number of Rumble downloads of an episode for first 30 days after publishing.
The number of Rumble downloads of an episode for first 7 days after publishing.
The duration of an episode of a podcast or other audio content.
The date of an episode of a podcast or other audio content uploaded.
The URL of the media file for an episode of a podcast or other audio content.
YouTube Video id or guid.
The percentage of total time of an episode that is ads.
The ads found in the episode, in placement order.
Array<{adId,advertiser,startTs,5 more}>
The unique identifier for an ad in the Podscribe platform.
The advertiser of an ad.
The start of the ad, in seconds from the beginning of the episode.
The end of the ad, in seconds from the beginning of the episode.
The ad placement group number.
The ad placement number.
The ad placement number in group.
The ad placement unit.
Download counts by normalized user agent, sorted by downloads descending
Array<{key}>
Present when episodesPageIndex or episodesPageSize query parameters are used.
{pageIndex,pageSize,rowCount}
Zero-based page index.
Number of episodes per page.
Total number of episodes available for pagination (up to 1000 most recent).
The share of the show’s reach that has not been exposed to the advertisers passed in the netNewReachAdvertisers query parameter, as a percentage between 0 and 100. Present only when netNewReachAdvertisers is used, the show is a podcast, and listening data exists for it in the requested window. Net new reach is only measured for podcasts, so YouTube, Rumble and Spotify video shows never carry this field.
{ "platform": "YouTube", "contentRisk": { "overallScore": "minimal" }}