Audience Size by Month

GET

/api/public/series/audience-size/{podscribe_show_id}

Note: only prefix impressions are included.

Prefix downloads, unique reach and episodes published for a show, by month.

This endpoint utilizes a task system.

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

Audience Size by Month

const url = 'https://backend.podscribe.ai/api/public/series/audience-size/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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/series/audience-size/example"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())

curl --request GET \
  --url https://backend.podscribe.ai/api/public/series/audience-size/example \
  --header 'Authorization: Bearer <token>'

Path Parameters

podscribe_show_id

required

string

The Podscribe show ID

Query Parameters

advertiser

string

The advertiser to get data for

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
Date	string	2026-04-01	Month bucket in YYYY-MM-DD format.
Prefix Downloads	number	128450	Prefix download count for episodes in that month.
Unique reach	number	84210	Estimated unique reach for that month.
Episodes Published	number	12	Number of episodes published for the show that month.