TransUnion Audience

GET

/api/public/series/transunion

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

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.

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.

Authorizations

• BearerAuth

Parameters

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 characters

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.

Responses

200

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

400

Bad request — neither podscribe_id nor itunes_id provided

Media typeapplication/json

object

message

string

Example^generated

{
  "message": "example"
}

403

Forbidden — user does not have Pro access

404

Show not found

Media typeapplication/json

object

message

string

Example^generated

{
  "message": "example"
}

500

Unexpected error

Media typeapplication/json

object

message

Nodejs Error

object

Example^generated

{
  "message": {}
}