Skip to main content

PodcastDto

A podcast owned by a network.

idstring

Unique identifier for the podcast.

Example: 7Hb2Kp9QvL3mNx0R8tZ4
createdAtdate-time

Timestamp when the podcast was created.

Example: 2026-01-15T09:30:00Z
updatedAtdate-time

Timestamp when the podcast was last updated.

Example: 2026-01-15T09:30:00Z
titlestring

Display title of the podcast.

Example: The Daily Tech
descriptionstringnullable

Short description of the podcast.

Example: A daily look at the latest in technology.
linkstringnullable

URL of the podcast's public website or landing page.

Example: https://example.com/podcasts/the-daily-tech
imageUrlstringnullable

URL of the podcast's cover artwork image.

Example: https://cdn.example.com/the-daily-tech/cover.jpg
feedUrlstring

URL of the podcast's RSS feed.

Example: https://feeds.example.com/the-daily-tech.xml
categoriesstring[]

Content categories the podcast belongs to.

languagestringnullable

Primary language of the podcast as an ISO 639-1 code.

Example: en
networkIdstring

Identifier of the network that owns this podcast.

Example: 7Hb2Kp9QvL3mNx0R8tZ4
primaryVoiceIdstringnullable

Identifier of the podcast's primary voice, if one is assigned.

Example: 7Hb2Kp9QvL3mNx0R8tZ4
primaryVoice objectnullable

The podcast's primary voice; present only when ?expand=primary_voice was requested.

idstring

Unique identifier for the voice.

Example: 7Hb2Kp9QvL3mNx0R8tZ4
titlestringnullable

Display name of the voice.

Example: Morning Host
statusstring

Lifecycle status; a voice is 'ready' once it has audio samples

Possible values: [pending, ready, archived, failed]

Example: ready
externalIds object

External system identifiers keyed by system name.

property name*string
statusstring

Podcast status

Possible values: [active, disabled]

Example: active
optInStatusstring

Opt-in status for advertising

Possible values: [not_started, pending, opted_in, declined]

Example: opted_in
excludedAdCategoriesstring[]

Ad categories excluded from advertising on this podcast.

downloadsPerMonthint64nullable

Estimated number of episode downloads per month.

Example: 125000
primaryContact object

The primary contact for this podcast.

emailstring

Email address of the contact

Example: ops@example.com
firstNamestring

First name of the contact

Example: Jane
lastNamestring

Last name of the contact

Example: Doe
rolestringnullable

Optional free-form role or title of the contact

Example: Head of Partnerships
contacts object[]

Additional contacts associated with this podcast.

  • Array [
  • emailstring

    Email address of the contact

    Example: ops@example.com
    firstNamestring

    First name of the contact

    Example: Jane
    lastNamestring

    Last name of the contact

    Example: Doe
    rolestringnullable

    Optional free-form role or title of the contact

    Example: Head of Partnerships
  • ]
  • PodcastDto
    {
    "id": "7Hb2Kp9QvL3mNx0R8tZ4",
    "createdAt": "2026-01-15T09:30:00Z",
    "updatedAt": "2026-01-15T09:30:00Z",
    "title": "The Daily Tech",
    "description": "A daily look at the latest in technology.",
    "link": "https://example.com/podcasts/the-daily-tech",
    "imageUrl": "https://cdn.example.com/the-daily-tech/cover.jpg",
    "feedUrl": "https://feeds.example.com/the-daily-tech.xml",
    "categories": [
    "string"
    ],
    "language": "en",
    "networkId": "7Hb2Kp9QvL3mNx0R8tZ4",
    "primaryVoiceId": "7Hb2Kp9QvL3mNx0R8tZ4",
    "primaryVoice": {
    "id": "7Hb2Kp9QvL3mNx0R8tZ4",
    "title": "Morning Host",
    "status": "ready"
    },
    "externalIds": {},
    "status": "active",
    "optInStatus": "opted_in",
    "excludedAdCategories": [
    "string"
    ],
    "downloadsPerMonth": 125000,
    "primaryContact": {
    "email": "ops@example.com",
    "firstName": "Jane",
    "lastName": "Doe",
    "role": "Head of Partnerships"
    },
    "contacts": [
    {
    "email": "ops@example.com",
    "firstName": "Jane",
    "lastName": "Doe",
    "role": "Head of Partnerships"
    }
    ]
    }