Top Advertisers

POST

/api/public/ranker/advertisers

Advertisers ranked by estimated ad spend over the last 12 months, with ad, show and episode counts.

This endpoint utilizes a task system.

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

Top Advertisers

const url = 'https://backend.podscribe.ai/api/public/ranker/advertisers';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"name":"example","chart":"top","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/advertisers"

payload = {
    "name": "example",
    "chart": "top",
    "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/advertisers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "chart": "top", "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)

chart

Matches the Ranker UI top/new/rising selector.

top

top rising new

Example

rising

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 advertiser based on spend.
Brand	string	Brand_1	Name of the advertised brand.
Top Publishers	string	Publisher_1, Publisher_2	Up to 3 top publishers of the advertiser, comma-separated.
Industry	string	Industry_1	Industry category associated with the brand.
Advertiser type	string	direct	`direct` or `branding`.
Estimated Spend	number	1231231	Estimated ad spend in USD over the last 12 months.
Change %	string	12.5%	Percent change in estimated spend, last 12 months against the previous 12.
Change $	number	150000	Dollar change in estimated spend, last 12 months against the previous 12.
Host Read %	string	89%	Percentage of ads that were host-read.
Show count	number	1999	Number of distinct shows the advertiser appeared on.
Show with host reads count	number	1999	Number of shows with host-read ads.
Episode count	number	30000	Total number of episodes containing this advertiser’s ads.
Ads count	number	45000	Total number of ads run by this advertiser.
First seen	string	3/8/2020	Date of the first detected ad from this advertiser.
Last seen	string	4/28/2025	Date of the most recent detected ad from this advertiser.
Top show genres	string	Genre1,Genre2	Comma-separated list of top show genres associated with the ads.
Agency	string	Agency_1	Agencies of the advertiser, comma-separated.
Child Advertiser	string	Brand_2	Child advertisers of the advertiser, comma-separated.
Parent Advertiser	string	Parent_1	Parent advertiser of the advertiser.
Lookup Name	string	brand_1	Advertiser identifier accepted by advertiser endpoints such as Individual Ads.
Advertiser Lists	string	List_1, List_2	Comma-separated advertiser lists this brand belongs to. `-` when it belongs to none.