Podcast Details

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

Get a podcast by ID or slug

Example request

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,
        "estimatedMonthyListenersCalculatedAt": "2026-01-15T09:30:00.000Z",
        "confidence": "high",
        "isDormant": true,
        "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
        }
      },
      "audioRetentionPolicy": "RETAIN_INDEFINITELY",
      "audioRetentionDays": 0
    }
  }
}

Request

Path parameters

podcastIdOrSlugstringrequired

Podengine ID, Apple ID, or slug

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired1 field

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

dailyweeklybi-weeklymonthlystalevery-stale

titleLatestCleanedstringrequirednullable

transcriptionModeunionrequired

websiteUrlstringrequirednullable