Skip to content

TransUnion Audience for multiple shows

POST
/api/public/series/transunion
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 ] }'

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.

Result file format:

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 number 12.4 Share of the show’s audience for the segment value.
Podcast Population Index number 134 Index compared with the podcast population baseline.
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
podscribe_ids
Array<number>
itunes_ids
Array<number>
Examplegenerated
{
"name": "example",
"podscribe_ids": [
1
],
"itunes_ids": [
1
]
}

Task created successfully

Media typeapplication/json
object
id

Task ID

string
status

Task status

string
Allowed values: pending done failed
url

Download URL (available when status is ‘done’)

string
Example
{
"status": "pending"
}

Bad request — neither podscribe_ids nor itunes_ids provided

Forbidden — user does not have Pro access

Show not found

Unexpected error