TransUnion Audience

GET

/api/public/series/transunion

Audience share and podcast population index per TransUnion attribute value, for one show.

Audience data from social channels is available through the API as well. Please contact Partnerships for enablement.

Requires a Pro account. At least one of podscribe_id or itunes_id must be supplied; passing neither returns HTTP 400. If both are provided, podscribe_id takes priority.

This endpoint utilizes a task system.

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

TransUnion Audience

const url = 'https://backend.podscribe.ai/api/public/series/transunion';
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);
}

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

Query Parameters

podscribe_id

number

Podscribe Show ID. Takes priority over itunes_id when both are provided.

itunes_id

number

iTunes ID. Used when podscribe_id is not provided.

name

string

(≤ 255 chars)

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.

Response Body

Task created successfully

application/json

Task ID

string<uuid>

status

Task status

pending done failed

url

Download URL (available when status is ‘done’)

string<uri>

Response example

{
  "status": "pending"
}

Result file

Field	Type	Example	Description
Show	string	The Daily	Name of the show.
Category	string	Demographics	Top-level TransUnion segment category.
Subcategory	string	Age	Nested TransUnion segment grouping within the category.
Attribute	string	Age 25-34	TransUnion audience attribute name.
Value	string	25-34	Segment value or bucket label for the attribute.
Percent	string	12.4%	Share of the show’s audience for the segment value, as a percentage.
Podcast Population Index	number	134	Index compared with the podcast population baseline.