TransUnion (Multi-Show)

POST

/api/public/series/transunion

Audience share and podcast population index per TransUnion attribute value, for each requested 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_ids or itunes_ids must be supplied.

This endpoint utilizes a task system.

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

TransUnion (Multi-Show)

const url = 'https://backend.podscribe.ai/api/public/series/transunion';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"name":"example","podscribe_ids":[1],"itunes_ids":[1]}'
};

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/transunion"

payload = {
    "name": "example",
    "podscribe_ids": [1],
    "itunes_ids": [1]
}
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/series/transunion \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "podscribe_ids": [ 1 ], "itunes_ids": [ 1 ] }'

Request Body^required

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)

podscribe_ids

Podscribe show IDs to include in the report.

Array<number>

itunes_ids

iTunes IDs of shows to include in the report.

Array<number>

Example^generated

{
  "name": "example",
  "podscribe_ids": [
    1
  ],
  "itunes_ids": [
    1
  ]
}

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.

TransUnion (Multi-Show)

Request Bodyrequired

Examplegenerated

Response Body

Result file

Request Body^required

Example^generated