Top Shows

POST

/api/public/ranker/series

Shows ranked by the sortBy metric, with audience, ad and demographic details.

This endpoint utilizes a task system.

Please read the description of Get status of file processing to understand how it works.

Top Shows

const url = 'https://backend.podscribe.ai/api/public/ranker/series';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"name":"example","platform":"podcast","country":"GLOBAL","sortBy":"rank","limit":250,"countryOfOrigin":["example"]}'
};

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/ranker/series"

payload = {
    "name": "example",
    "platform": "podcast",
    "country": "GLOBAL",
    "sortBy": "rank",
    "limit": 250,
    "countryOfOrigin": ["example"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

curl --request POST \
  --url https://backend.podscribe.ai/api/public/ranker/series \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "platform": "podcast", "country": "GLOBAL", "sortBy": "rank", "limit": 250, "countryOfOrigin": [ "example" ] }'

Request Body^required

application/json

name

Optional display name for the generated report. Shown in the Reports UI. Ignored when an identical cached report is reused; pass a new request (or wait for cache expiry) to apply a new name.

string

(≤ 255 chars)

platform

Content platform

podcast

podcast youtube

country

Country

GLOBAL

GLOBAL US GB CA AU DE FR MX IE JP ES IN BR IT AR KR SA AE ID EG SG

16 moreLess

sortBy

Defines the field used to sort the results returned. Supported values depend on platform; youtube supports a validated subset of the values listed below. Metric fields are returned highest-value-first, date fields newest-first, and rank best-first with rank 1 at the top. title sorts A to Z: titles starting with a digit come before letters, and titles in non-latin scripts come before latin ones. Every remaining field is returned in descending order. Defaults to monthlyListeners for podcast; youtube requests must explicitly pass a sortBy value from its supported subset.

rank title monthlyListeners avgDownloadsPerEpisode podcastAvgDownloadsPerEpisode ytAvgDownloadsPerEpisode rumbleAvgDownloadsPerEpisode spotifyAvgDownloadsPerEpisode monthlyDownloads podcastMonthlyDownloads ytMonthlyDownloads rumbleImpressions spotifyImpressions itunesNumRatings itunesNumRatingsGlobal avgItunesRating spotifyNumRatings spotifyCalcRatings countAds adLoad changeAdLoad ytAdLoad renewalRate hostRead directRes topAdvertisers contentRisk optedIntoSpotifyVideo trackingSetupForSpotifyVideo usesAppleHls youtubeAnalyticsConnectedStatus malePercent avgAge avgIncome Location: by city Industries Occupations Race (US only) Marital status Parental status firstPublishedAt lastPublishedAt lastYtPublishedAt episodesCountPerWeek ytEpisodesCountPerWeek totalEpisodesCount ytTotalEpisodesCount simulcastEpisodeMatchPercent l10SimulcastMatchRate podcastEngScore podcastRecentEng podcastEngPercentile youtubeEngScore youtubeEngPercentile age_17_and_under age_18_to_20 age_21_to_24 age_25_to_29 age_30_to_34 age_35_to_44 age_45_to_54 age_55_to_64 age_65_and_over rssLocation hostingPlatform changeTotal youtubeCommentsMonthly youtubeLikesMonthly socialViewsMonthly socialCommentsMonthly socialLikesMonthly youtubeRssSync

67 moreLess

limit

Specifies the maximum number of results to return.

integer

250

countryOfOrigin

Filter shows by country of origin (ISO Alpha-2 codes)

Array<string>

Response Body

application/json

ID of the file processing task.

string<uuid>

status

Task status: pending, done or failed.

pending done failed

url

Link to download the result file. Returned once the file is ready.

string<uri>

Response example

{
  "status": "pending"
}

Result file

Field	Type	Example	Description
Rank	number	1	Ranking of the show in the dataset.
Show	string	The Show	Name of the podcast show.
RSS Email	string	foo@bar.baz	Contact email associated with the podcast’s RSS feed.
Publisher	string	Publisher	Organization or company publishing the podcast.
Publisher Email	string	foo@bar.baz	Contact email of the publisher.
Genre	string	True Crime	Genre or category of the podcast.
Content Risk	string	medium	Content safety or risk level classification.
Estimated reach	number	8335118	Estimated number of individuals reached.
Estimated downloads per episode	number	1968697	Estimated downloads per each episode.
Estimated downloads per month	number	18310294	Estimated total monthly downloads across episodes.
Estimated podcast downloads per episode	number	1902865	Estimated per-episode downloads from podcast platforms.
Estimated podcast downloads per month	number	17989350	Estimated monthly podcast platform downloads.
Estimated YouTube downloads per episode	number	53123	Estimated per-episode views on YouTube.
Estimated YouTube downloads per month	number	312542	Estimated monthly views from YouTube.
Estimated Spotify downloads per episode	number	312542	Spotify-specific episode views (if available).
Estimated Spotify downloads per month	number	312542	Spotify-specific monthly views (if available).
Estimated Rumble downloads per episode	number	312542	Rumble-specific episode views (if available).
Estimated Rumble downloads per month	number	312542	Rumble-specific monthly views (if available).
Number of ads	number	1493	Total number of ads within the dataset for this show.
Ad load %	string	14%	Ad load percentage (amount of content dedicated to ads).
Renewal rate	string	56%	Percentage of ad contracts that were renewed.
Host read %	string	69%	Percentage of ads read by the host.
Direct response %	string	57%	Share of ads optimized for direct response (e.g., promo codes).
Top advertisers	string	Advertiser1,Advertiser2,…	List of top advertisers associated with the show.
Male %	string	23%	Percentage of male listeners.
Average age	number	32	Average listener age.
Average income	string	$52,755	Average household income of listeners.
Location	string	Los Angeles, CA: 4.3%…	Top listener locations with percentages.
Industries	string	Education: 8.5%…	Listener industries with prevalence percentages.
Occupations	string	Nurses: 2.9%,Teachers:…	Common occupations among listeners.
Ethnicity	string	White/caucasian: 82.2%…	Listener ethnicity breakdown.
Marital status	string	Single: 60.2%…	Breakdown of listeners by marital status.
Parental status	string	Parents: 19.1%	Percentage of listeners who are parents.
Simulcast YouTube series ID	number	2517763	Internal identifier for the show’s simulcast YouTube version.
First Publish	string	2017-12-18T00:01:00.000Z	Date of the first published episode (ISO timestamp format).
Last Publish	string	2017-12-18T00:01:00.000Z	Date of the last published episode (ISO timestamp format).
Last Publish (YT)	string	2017-12-18T00:01:00.000Z	Date of the last published YouTube episode (ISO timestamp format).
RSS Episodes per week	number	1	Average number of episodes published per week.
YT Episodes per week	number	1	Average number of episodes published per week.
RSS - Total # of Episodes	number	100	Total number of episodes in the RSS feed
YT - Total # of Episodes	number	100	Total number of episodes in the YouTube feed
Youtube URL	string	https://www.youtube.com/example	URL of the show on YouTube.
RSS Feed URL	string	https://www.rss.com/example	URL of the RSS feed
RSS Language	string	English	Language from RSS feed
Country of Origin	string	United States	The country with the highest number of listeners
Simulcast match percent	string	10%	Percentage of podcast episodes also available on YouTube or Rumble
L10 Simulcast match percent	string	10%	Percentage of last 10 RSS episodes that match a YouTube video
Content Detected Language	string	English	Most frequent languages from podcast episodes
RSS Location	string	Los Angeles, CA: 4.3%…	The primary country/city inferred from the RSS feed metadata where available
Hosting Platform	string	Megaphone	Podcast hosting platform detected from the RSS feed
Opted Into Spotify Video	string	Yes	`Yes` when the show is opted into Spotify Video, `-` otherwise
Tracking Set Up For Spotify Video	string	Yes	`Yes` when Spotify Video tracking is set up for the show, `-` otherwise
Show URL	string	https://app.podscribe.com/show/123	URL of the show
Apple HLS Enabled	string	Yes	`Yes` when the show serves Apple HLS audio, `-` otherwise
Show ID	number	12345	Podscribe internal identifier of the show (final segment of Show URL).
YouTube Connection	string	Yes	`Yes` when YouTube Analytics is connected, `No` when not, `-` when unknown.
YouTube Engaged Views Per Episode	number	20718	YouTube Engaged Views per episode.
YouTube Engaged Views Per Month	number	121891	YouTube Engaged Views per month.

Top Shows

Request Bodyrequired

Response Body

Result file

Request Body^required