Top Publishers Report

POST

/api/public/ranker/publishers

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

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 publisher based on performance metrics.
Publisher	string	PublisherName	Name of the podcast publisher or network.
# of Show	number	100	Total number of distinct shows under this publisher.
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.
Average ad load	number	5.32121	Average number of ads inserted per episode for this publisher.

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

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": {}
}