Podcast Details

GET https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug

Get a podcast by its Pod Engine ID or slug, Apple Podcasts ID, Spotify show ID or podcast:guid. The response includes `platforms`: where the show is listed on Apple Podcasts, Spotify and YouTube. To look a podcast up by its RSS feed URL, use Podcast Details by Feed URL.

API token required Markdown for LLMs

OpenAPI spec

Example request

Install & configure

curl -X GET "https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_TOKEN"

const options = {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  }
};

fetch("https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug", options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
}

response = requests.get("https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug", headers=headers)
print(response.json())

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "YOUR_API_TOKEN");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var response = await client.GetAsync("https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug");
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug", nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "YOUR_API_TOKEN")
	
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

import { PodEngine } from '@podengine/sdk';

const pe = new PodEngine({ apiKey: process.env.PODENGINE_API_KEY });

const data = await pe.podcasts.getPodcast({
  podcastIdOrSlug: 'this-week-in-startups',
});

console.log(data);

import os

from podengine import PodEngine

pe = PodEngine(api_key=os.environ["PODENGINE_API_KEY"])

data = pe.podcasts.get_podcast(
    podcast_id_or_slug="this-week-in-startups",
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "podcast": {
      "author": "string",
      "authorityScore": {
        "calculatedAt": "2026-01-15T09:30:00.000Z",
        "authorityScore": 0,
        "qualityScore": 0,
        "youtubeScore": 0,
        "socialScore": 0,
        "engagementScore": 0
      },
      "genres": [
        "string"
      ],
      "id": "string",
      "imageUrl": "string",
      "language": "string",
      "lastEpisodePublishedAt": "2026-01-15T09:30:00.000Z",
      "slug": "string",
      "title": "string",
      "titleLatest": "string",
      "appleId": 0,
      "blocked": {
        "blockedDate": "2026-01-15T09:30:00.000Z",
        "blockedReason": "string"
      },
      "description": "string",
      "emails": [
        "string"
      ],
      "explicitRss": true,
      "hostNames": [
        "string"
      ],
      "ignore": true,
      "ignoreReason": "string",
      "neverTranscribe": true,
      "neverTranscribeReason": "string",
      "isClaimed": true,
      "podcastAffiliation": {
        "affiliateOrganizationName": "string",
        "affiliationType": "academic"
      },
      "podcastDirectoryLinks": {
        "amazonmusic": "https://example.com",
        "anchor": "https://example.com",
        "antennapod": "https://example.com",
        "anytimeplayer": "https://example.com",
        "apollo": "https://example.com",
        "apple": "https://example.com",
        "audible": "https://example.com",
        "breez": "https://example.com",
        "castamatic": "https://example.com",
        "castbox": "https://example.com",
        "castro": "https://example.com",
        "curiocaster": "https://example.com",
        "fountain": "https://example.com",
        "goodpods": "https://example.com",
        "google": "https://example.com",
        "gpodder": "https://example.com",
        "iheartradio": "https://example.com",
        "listennotes": "https://example.com",
        "lnbeats": "https://example.com",
        "moonfm": "https://example.com",
        "overcast": "https://example.com",
        "playerfm": "https://example.com",
        "pocketcasts": "https://example.com",
        "podbean": "https://example.com",
        "podcastaddict": "https://example.com",
        "podcastguru": "https://example.com",
        "podcastrepublic": "https://example.com",
        "podchaser": "https://example.com",
        "podfriend": "https://example.com",
        "podknife": "https://example.com",
        "podlp": "https://example.com",
        "podnews": "https://example.com",
        "podscan": "https://example.com",
        "podscribe": "https://example.com",
        "podstation": "https://example.com",
        "podurama": "https://example.com",
        "podverse": "https://example.com",
        "radiopublic": "https://example.com",
        "rephonic": "https://example.com",
        "sonnet": "https://example.com",
        "spotify": "https://example.com",
        "stenofm": "https://example.com",
        "truefans": "https://example.com",
        "tunein": "https://example.com",
        "youtubemusic": "https://example.com"
      },
      "podcastHasGuests": true,
      "podcastHasSponsors": true,
      "podcastLocations": [
        "string"
      ],
      "primaryContactEmail": "string",
      "rssFeedUrl": "string",
      "socialMediaLinks": [
        {
          "socialMediaType": "beehiiv",
          "url": "https://example.com",
          "sources": [
            "apple-podcasts"
          ]
        }
      ],
      "spotifyId": "string",
      "stats": {
        "downloadCount": 0,
        "episodeCount": 0,
        "latestPublishedAt": "2026-01-15T09:30:00.000Z",
        "firstEpisodePublishedAt": "2026-01-15T09:30:00.000Z",
        "transcriptsCount": 0,
        "updateFrequency": "daily"
      },
      "titleLatestCleaned": "string",
      "transcriptionMode": {
        "mode": "none",
        "transcribeSince": null
      },
      "websiteUrl": "string",
      "audienceEstimate": {
        "audienceDemographics": {
          "ageRange": "Under 18",
          "genderSkew": "Male 0% Female 100%",
          "educationLevel": "No High School",
          "incomeLevel": "Under $25K",
          "exampleListenerProfile": "string"
        },
        "estimatedMonthlyListeners": 0,
        "estimatedMonthlyListenersBucket": "0-1K",
        "estimatedMonthyListenersCalculatedAt": "2026-01-15T09:30:00.000Z",
        "confidence": "high",
        "isDormant": true,
        "estimatedMonthlyAudioListeners": 0,
        "estimatedMonthlyYoutubeViews": 0,
        "hasOp3Analytics": true,
        "op3Downloads": {
          "unit": "downloads",
          "source": "op3",
          "basis": "trailing_30_days",
          "last_synced_at": "2026-01-15T09:30:00.000Z",
          "source_as_of": "2026-01-15T09:30:00.000Z",
          "measurement_recorded_at": "2026-01-15T09:30:00.000Z",
          "coverage": "unknown",
          "freshness": "fresh",
          "status": "available",
          "value": 0,
          "reason": null
        },
        "hostReported": {
          "downloadsPerEpisode30d": 0,
          "source": "string",
          "sourceDetail": "string",
          "reportedAt": "2026-01-15T09:30:00.000Z"
        }
      },
      "audioRetentionPolicy": "RETAIN_INDEFINITELY",
      "audioRetentionDays": 0
    },
    "platforms": {
      "apple": {
        "id": 0,
        "url": "https://example.com"
      },
      "spotify": {
        "id": "string",
        "url": "https://example.com",
        "verifiedAt": "2026-01-15T09:30:00.000Z"
      },
      "youtube": {
        "channelId": "string",
        "url": "https://example.com",
        "tier": "associated",
        "role": "primary",
        "associatedAt": "2026-01-15T09:30:00.000Z"
      }
    }
  }
}

Request

Path parameters

podcastIdOrSlugstringrequired

Pod Engine ID or slug, Apple Podcasts ID, Spotify show ID, or podcast:guid

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired2 fields

podcastobjectrequired37 fields

authorstringrequirednullable

authorityScoreobjectrequirednullable6 fields

calculatedAtdaterequired

authorityScorenumberrequired

This is the weighted total authority score of the podcast, out of 100

qualityScorenumberrequired

This is the quality score of the podcast, out of 100

youtubeScorenumberrequired

This is the YouTube score of the podcast, out of 100

socialScorenumberrequired

This is the social score of the podcast, out of 100

engagementScorenumberrequired

This is the engagement score of the podcast, out of 100

genresarray of stringrequired

idstringrequired

imageUrlstringrequirednullable

languagestringrequired

lastEpisodePublishedAtdaterequired

slugstringrequired

titlestringrequired

titleLateststringrequired

appleIdnumberrequired

blockedobject2 fields

blockedDatedaterequired

blockedReasonstring

descriptionstringrequirednullable

emailsarray of stringrequired

explicitRssbooleanrequirednullable

hostNamesarray of stringrequirednullable

ignorebooleanrequired

ignoreReasonstring

neverTranscribeboolean

neverTranscribeReasonstring

isClaimedbooleanrequired

podcastAffiliationobjectrequirednullable2 fields

affiliateOrganizationNamestringnullable

The name of the affiliate organization

affiliationTypeenumnullable

The type of affiliation from the list: academic, branded, celebrity, government, independent, legacy media, podcast company, new media, not for profit, religious, other, unknown

academicbrandedcelebritygovernmentindependentlegacy mediapodcast companynew medianot for profitreligiousotherunknown

podcastDirectoryLinksobjectrequired45 fields

amazonmusicstringurl

anchorstringurl

antennapodstringurl

anytimeplayerstringurl

apollostringurl

applestringurl

audiblestringurl

breezstringurl

castamaticstringurl

castboxstringurl

castrostringurl

curiocasterstringurl

fountainstringurl

goodpodsstringurl

googlestringurl

gpodderstringurl

iheartradiostringurl

listennotesstringurl

lnbeatsstringurl

moonfmstringurl

overcaststringurl

playerfmstringurl

pocketcastsstringurl

podbeanstringurl

podcastaddictstringurl

podcastgurustringurl

podcastrepublicstringurl

podchaserstringurl

podfriendstringurl

podknifestringurl

podlpstringurl

podnewsstringurl

podscanstringurl

podscribestringurl

podstationstringurl

poduramastringurl

podversestringurl

radiopublicstringurl

rephonicstringurl

sonnetstringurl

spotifystringurl

stenofmstringurl

truefansstringurl

tuneinstringurl

youtubemusicstringurl

podcastHasGuestsbooleanrequirednullable

podcastHasSponsorsbooleanrequirednullable

podcastLocationsarray of stringrequirednullable

primaryContactEmailstringrequirednullable

rssFeedUrlstringrequired

socialMediaLinksarray of objectrequired3 fields

socialMediaTypeenumrequired

Social platform associated with the profile URL.

beehiivbehanceblueskydiscordfacebookgithubinstagramlinkedinlinktreemastodonmediumpatreonpinterestredditsnapchatsoundcloudsubstackthreadstiktoktumblrtwitchtwittervimeowhatsappyoutube

urlstringrequiredurl

Full URL of the social media profile.

sourcesarray of enumrequired

apple-podcastsbright-data-datasetgoogle-searchlinktreepodcast-websitepodchaserrephonicrssyoutube-channel-linksyoutube-episode-searchyoutube-serpyoutube-api-search

spotifyIdstringrequirednullable

statsobjectrequired6 fields

downloadCountnumberrequired

episodeCountnumberrequired

latestPublishedAtdaterequirednullable

firstEpisodePublishedAtdaterequirednullable

transcriptsCountnumberrequired

updateFrequencyenumrequired

How often the show publishes new episodes, based on the typical gap between its recent episodes. daily: about every day. weekly: every 2–10 days. bi-weekly: every 10–20 days. monthly: less often than that. stale: no new episode for over 90 days, or for much longer than its usual gap. very-stale: no new episode for over a year.

dailyweeklybi-weeklymonthlystalevery-stale

titleLatestCleanedstringrequirednullable

transcriptionModeunionrequired

websiteUrlstringrequirednullable

audienceEstimateobject11 fields

audienceDemographicsobjectrequirednullable5 fields

ageRangeenumrequired

The age range of the audience as a string.

Under 1818-2425-3435-4445-5455+

genderSkewenumrequired

How the audience is skewed in terms of gender.

Male 0% Female 100%Male 20% Female 80%Male 40% Female 60%Male 50% Female 50%Male 60% Female 40%Male 80% Female 20%Male 100% Female 0%

educationLevelenumrequired

The probable education levels of the audience.

No High SchoolHigh SchoolSome CollegeBachelors DegreeMasters DegreeDoctorate

incomeLevelenumrequired

The probable income levels of the audience.

Under $25K$25K-$50K$50K-$75K$75K-$100K$100K-$150K$150K-$200K$200K+

exampleListenerProfilestringrequired

An example profile of the audience. This is a description of the audience that you can use to describe the audience to an advertiser.

estimatedMonthlyListenersnumberrequirednullable

estimatedMonthlyListenersBucketenumnullable

Bucket for the estimated monthly listeners: 0-1K, 1K-10K, 10K-100K, 100K-1M or 1M+. 0-1K means the estimate is under 1,000, even when the rounded figure reads 1,000. Null means no estimate is available.

0-1K1K-10K10K-100K100K-1M1M+

estimatedMonthyListenersCalculatedAtdaterequirednullable

confidenceenumnullable

highmediumlow

isDormantbooleannullable

estimatedMonthlyAudioListenersnumbernullable

The podcast-app part of estimatedMonthlyListeners, unrounded. Null when not available.

estimatedMonthlyYoutubeViewsnumbernullable

The YouTube part of estimatedMonthlyListeners (monthly views of the show on its matched YouTube channel), unrounded. Null when not available.

hasOp3Analyticsboolean

op3Downloadsunion

hostReportedobjectnullable4 fields

downloadsPerEpisode30dnumberrequired

sourcestringrequired

sourceDetailstringrequirednullable

reportedAtdaterequired

audioRetentionPolicyenum

RETAIN_INDEFINITELYRETAIN_DAYSRETAIN_UNTIL_TRANSCRIBED

audioRetentionDaysnumbernullable

platformsobject3 fields

Where the podcast is listed: Apple Podcasts, Spotify and YouTube.

appleobjectrequired2 fields

Apple Podcasts. Every podcast we track has one.

idnumberrequired

Apple Podcasts ID

urlstringrequiredurl

Apple Podcasts show page

spotifyobjectrequirednullable3 fields

Spotify, when we have matched the show. Spotify has no lookup by feed, so each match is inferred; branch on `verifiedAt` to decide whether to trust it. Null means we have no match, not that the show is missing from Spotify.

idstringrequired

Spotify show ID

urlstringrequiredurl

Spotify show page, https://open.spotify.com/show/<id>

verifiedAtstringrequirednullabledatetime

When the link passed our identity check (the Spotify show is this podcast). Null means it has not passed: confirm it with the publisher before relying on it.

youtubeobjectrequirednullable5 fields

The show’s YouTube channel, when we have one: its own channel first, then a channel that carries it, then our best unconfirmed match. Null means we have no channel match.

channelIdstringrequired

YouTube channel ID

urlstringrequiredurl

YouTube channel page

tierenumrequired

`associated`: the channel passed our association checks; `role` says whether it is the show’s own channel. `candidate`: the best match we have that has not passed them yet.

associatedcandidate

roleenumrequirednullable

`primary`: the show’s own channel; its main identity is the podcast. `valid_secondary`: a host, network, clips or mixed channel that carries the show, returned only when the show has no primary channel. Null for a candidate, which has no role until it passes.

primaryvalid_secondary

associatedAtstringrequirednullabledatetime

When the channel last passed our association checks. Null for a candidate: confirm it with the publisher before relying on it.