Show Info — Episodes, Advertisers, Downloads, etc

GET

/api/public/series/episodes/{id}

const url = 'https://backend.podscribe.ai/api/public/series/episodes/example?episodesPageIndex=0&episodesPageSize=25&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);
}

curl --request GET \
  --url 'https://backend.podscribe.ai/api/public/series/episodes/example?episodesPageIndex=0&episodesPageSize=25&months=1' \
  --header 'Authorization: Bearer <token>'

Authorizations

BearerAuth

Parameters

Path Parameters

required

string

ITunes ID / YouTube Channel ID / YouTube Playlist ID

Query Parameters

episodesPageIndex

integer

Zero-based page index for episodes. Use together with episodesPageSize.

episodesPageSize

integer

default: 25 >= 1 <= 100

Episodes per page (max 100). Use together with episodesPageIndex.

netNewReachAdvertisers

string

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.

months

integer

default: 1 >= 1 <= 3

Size of the listening window used for net new reach, in months. Only applies together with netNewReachAdvertisers.

Responses

200

application/json

object

podscribeSeriesId

The unique identifier for a show in the Podscribe platform.

number

title

The title of a series of a podcast or other audio content.

string

platform

string

monthlyListeners

The estimated number of listeners each month who download at least one episode of the podcast (does not include YouTube viewers).

number

monthlyDownloads

The total estimated number of downloads the show receives across all episodes each month.

number

avgDownloadsPerEpisode

The average estimated number of downloads episodes receive within the first 60 days from publish date. Useful for estimating delivery for episodic buys.

number

ytAvgDownloadsPerEpisode

The average estimated number of views episodes receive within the first 60 days from publish date (includes both podcast and YouTube). Useful for estimating delivery for episodic buys.

number

ytMonthlyDownloads

The total estimated number of views the show receives across all episodes each month.

number

spotifyAvgDownloadsPerEpisode

The average estimated number of Spotify downloads episodes receive within the first 60 days from publish date. Useful for estimating delivery for episodic buys.

number

spotifyMonthlyDownloads

The total estimated number of Spotify downloads the show receives across all episodes each month.

number

rumbleAvgDownloadsPerEpisode

The average estimated number of Rumble downloads episodes receive within the first 60 days from publish date. Useful for estimating delivery for episodic buys.

number

rumbleMonthlyDownloads

The total estimated number of Rumble downloads the show receives across all episodes each month.

number

podcastDownloads

The total estimated number of podcast downloads the show receives across all episodes each month.

number

podcastAvgDownloadsPerEpisode

The average estimated number of podcast downloads episodes receive within the first 60 days from publish date. Useful for estimating delivery for episodic buys.

number

directRes

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.

number

hostRead

The percentage of the ads read by the host.

number

countAds

The total number of ads in Podscribe across all episodes of a show.

number

topAdvertisers

Array<string>

similarShows

Up to 50 podcast shows similar to this show, sorted by contentSimilarity (descending). Empty for non-podcast shows.

Array<object>

object

seriesId

The unique identifier for a show in the Podscribe platform.

number

title

The title of the similar podcast show.

string

contentSimilarity

Content topic similarity score between the reference show and this show.

number

audienceSimilarityTransunion

Audience similarity based on TransUnion demographic data.

number

audienceSimilaritySocial

Audience similarity based on social media data.

number

audienceSimilarityOverlap

Percentage of the reference show’s audience that also listens to this show.

number

audienceSimilarityOverlapReverse

Percentage of this show’s audience that also listens to the reference show.

number

renewalRate

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.

number

adLoad

number

adLoadYT

number

isPodscribePrefixPlaced

Whether the Podscribe prefix has been placed on the show.

boolean

optedIntoSpotifyVideo

Whether the show has opted into Spotify Video.

boolean

trackingSetupForSpotifyVideo

Whether Spotify Video tracking is set up for the show.

boolean

spotifyVideoOptInDate

Spotify Video opt-in date, ISO 8601 date-time.

string format: date-time

nullable

twitter

The show’s Twitter / X link, when known.

string

nullable

facebook

The show’s Facebook link, when known.

string

nullable

instagram

The show’s Instagram link, when known.

string

nullable

youtube

The show’s YouTube link, when known.

string

nullable

tiktok

The show’s TikTok link, when known.

string

nullable

numTwitterFans

The number of Twitter / X followers for the show, when known.

number

nullable

numFbFans

The number of Facebook followers for the show, when known.

number

nullable

numIgFans

The number of Instagram followers for the show, when known.

number

nullable

numYoutubeFans

The number of YouTube subscribers for the show, when known.

number

nullable

numTiktokFans

The number of TikTok followers for the show, when known.

number

nullable

contentRisk

object

seriesId

The unique identifier for a show in the Podscribe platform.

number

overallScore

The overall content risk score.

string

Allowed values: minimal low medium high floor

scoreByCategory

A breakdown of the content risk scores by category.

object

key

additional properties

string

episodes

Array<object>

object

title

The title of an episode of a podcast or other audio content.

string

podscribeEpisodeId

The unique identifier for an episode in the Podscribe platform.

number

description

The description of an episode of a podcast or other audio content.

string

downloads

The number of total downloads of an episode. audio content.

number

downloadsAt30Days

The number of total downloads of an episode for first 30 days after publishing.

number

downloadsAt7Days

The number of total downloads of an episode for first 7 days after publishing.

number

podcastDownloads

The number of downloads of an episode for podcast.

number

podcastDownloadsAt30Days

The number of downloads of an episode for first 30 days after publishing.

number

podcastDownloadsAt7Days

The number of downloads of an episode for first 7 days after publishing.

number

youtubeDownloads

The number of Youtube downloads of an episode for YouTube.

number

youtubeDownloadsAt30Days

The number of Youtube downloads of an episode for first 30 days after publishing.

number

youtubeDownloadsAt7Days

The number of Youtube downloads of an episode for first 7 days after publishing.

number

spotifyDownloads

The number of Spotify downloads of an episode for Spotify.

number

spotifyDownloadsAt30Days

The number of Spotify downloads of an episode for first 30 days after publishing.

number

spotifyDownloadsAt7Days

The number of Spotify downloads of an episode for first 7 days after publishing.

number

rumbleDownloads

The number of Rumble downloads of an episode for Rumble.

number

rumbleDownloadsAt30Days

The number of Rumble downloads of an episode for first 30 days after publishing.

number

rumbleDownloadsAt7Days

The number of Rumble downloads of an episode for first 7 days after publishing.

number

duration

The duration of an episode of a podcast or other audio content.

number

uploadedAt

The date of an episode of a podcast or other audio content uploaded.

string

url

The URL of the media file for an episode of a podcast or other audio content.

string

guid

YouTube Video id or guid.

string

adLoad

The percentage of total time of an episode that is ads.

number

ads

Array<object>

object

adId

The unique identifier for an ad in the Podscribe platform.

number

advertiser

The advertiser of an ad.

string

startTs

The start ad timestamp.

string

endTs

The end ad timestamp.

string

placementGroupNum

The ad placement group number.

string

placementNum

The ad placement number.

string

placementNumInGroup

The ad placement number in group.

string

placementUnit

The ad placement unit.

string

userAgents

Download counts by normalized user agent, sorted by downloads descending

Array<object>

object

>= 1 properties <= 1 properties

key

additional properties

number

episodesPagination

Present when episodesPageIndex or episodesPageSize query parameters are used.

object

pageIndex

Zero-based page index.

integer

pageSize

Number of episodes per page.

integer

rowCount

Total number of episodes available for pagination (up to 1000 most recent).

integer

netNewReachPercent

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.

number

Example

{
  "contentRisk": {
    "overallScore": "minimal"
  }
}

400

Invalid query parameters (for example, episodesPageIndex is not a non-negative integer, episodesPageSize is not an integer between 1 and 100, netNewReachAdvertisers is empty or lists more than 10 advertisers, or netNewReachAdvertisers is used with a months value that is not an integer between 1 and 3).

application/json

object

message

required

Validation error message

string

statusCode

HTTP status code. Present on netNewReachAdvertisers and months validation errors.

number

Example^generated

{
  "message": "example",
  "statusCode": 1
}

403

The API key does not have access to one of the advertisers passed in netNewReachAdvertisers.

application/json

object

message

Nodejs Error

object

Example^generated

{
  "message": {}
}

422

Unprocessable Entity

500

Unexpected error.

application/json

object

message

Nodejs Error

object

Example^generated

{
  "message": {}
}

Show Info — Episodes, Advertisers, Downloads, etc

Authorizations

Parameters

Path Parameters

Query Parameters

Responses

200

Example

400

Examplegenerated

403

Examplegenerated

422

500

Examplegenerated

Example^generated

Example^generated

Example^generated