Top Publishers

POST

/api/public/ranker/publishers

Publishers ranked by estimated monthly audio reach, with show counts, downloads and ad load.

This endpoint utilizes a task system.

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

Top Publishers

const url = 'https://backend.podscribe.ai/api/public/ranker/publishers';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"name":"example","limit":250}'
};

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/publishers"

payload = {
    "name": "example",
    "limit": 250
}
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/publishers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "limit": 250 }'

Request Body

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)

limit

Specifies the maximum number of results to return.

integer

250

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 publisher based on performance metrics.
Publisher	string	PublisherName	Name of the podcast publisher or network.
# of Shows	number	100	Total number of distinct shows under this publisher.
Top Shows	string	Show A, Show B	The publisher’s top shows, comma-separated.
Estimated Monthly Audio Reach	number	1231232	Estimated number of unique listeners reached per month.
Monthly Downloads & Views	number	1232323	Sum of monthly downloads and views across all shows.
Podcast Downloads	number	1100000	Monthly podcast downloads across all shows.
Streaming Impressions	number	50000	Monthly streaming impressions across all shows.
YouTube Views	number	80000	YouTube views in the last month across all shows.
Monthly YouTube Comments	number	1200	YouTube comments in the last month across all shows.
Monthly YouTube Likes	number	9000	YouTube likes in the last month across all shows.
Rumble Views	number	3000	Rumble views in the last month across all shows.
Spotify Monthly Streams	number	20000	Spotify streams in the last month across all shows.
Monthly Social Views	number	40000	Social platform views in the last month across all shows.
Monthly Social Comments	number	500	Social platform comments in the last month across all shows.
Monthly Social Likes	number	7000	Social platform likes in the last month across all shows.
Host Read %	string	45.5%	Share of the publisher’s ads read by the host.
Dir. Res. %	string	60.25%	Share of the publisher’s advertisers that are direct response.
Ad Load	string	5.32%	Average ad load across this publisher’s shows, as a percentage.
Top Advertisers	string	Advertiser1, Advertiser2	The publisher’s top 3 advertisers by estimated spend.