Top Advertisers Report

POST

/api/public/ranker/advertisers

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 }'

This endpoint utilizes a task system.

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

Result file format:

Field	Type	Example	Description
Rank	number	1	Ranking of the advertiser based on spend.
Brand	string	Brand_1	Name of the advertised brand.
Industry	string	Industry_1	Industry category associated with the brand.
Advertiser type	string	direct	Indicates whether the advertiser is direct or via an agency.
Estimate Spend	number	1231231	Estimated ad spend in USD.
Change over the past 1 month %	string	-	Percent change in spend over the past month.
Change over the past 3 months %	string	-	Percent change in spend over the past 3 months.
Change over the past 12 months %	string	-	Percent change in spend over the past 12 months.
Change over the past 1 month $	number	-	Dollar change in spend over the past month.
Change over the past 3 months $	number	-	Dollar change in spend over the past 3 months.
Change over the past 12 months $	number	-	Dollar change in spend over the past 12 months.
Host Read %	number	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.
Lookup Name	string	brand_1	Advertiser identifier accepted by advertiser endpoints such as Individual Ads.

Authorizations

• BearerAuth

Request Body

Media typeapplication/json

object

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 characters

chart

Matches the Ranker UI top/new/rising selector.

string

default: top

Allowed values: top rising new

Example

rising

limit

Specifies the maximum number of results to return.

integer

default: 250

Responses

200

OK

Media typeapplication/json

object

id

string

status

string

url

string

Example^generated

{
  "id": "example",
  "status": "example",
  "url": "example"
}

400

Invalid data

500

Unexpected error.

Media typeapplication/json

object

message

Nodejs Error

object

Example^generated

{
  "message": {}
}