Podcast Episodes

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

Get the episodes for a podcast

Example request

curl -X GET "https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/episodes" \
  -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/episodes", 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/episodes", 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/episodes");
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/episodes", 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.getPodcastEpisodes({
  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_episodes(
    podcast_id_or_slug="this-week-in-startups",
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "options": {
      "hasTranscript": true,
      "skip": 0,
      "limit": 1
    },
    "totalEpisodes": 0,
    "totalTranscripts": 0,
    "podcastWithEpisodes": {
      "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"
      },
      "episodes": [
        {
          "deepAnalysisRequestedAt": "2026-01-15T09:30:00.000Z",
          "description": "string",
          "durationSeconds": 0,
          "enclosureUrl": "string",
          "episodeId": "0eaa5978-d577-48fd-bc2a-68fb355b41e1",
          "episodeGuestsAndHosts": [
            {
              "name": "string",
              "type": "host",
              "imageUrl": "string"
            }
          ],
          "episodeSlug": "string",
          "episodeShortDescription": "string",
          "episodeSponsors": [
            "string"
          ],
          "hasTranscript": true,
          "hasVideo": true,
          "videoUrl": "https://example.com",
          "imageUrl": "string",
          "episodeThumbnailRssUrl": "string",
          "podcastId": "0eaa5978-d577-48fd-bc2a-68fb355b41e1",
          "podcastSlug": "string",
          "publishedAt": "2026-01-15T09:30:00.000Z",
          "title": "string",
          "transcriptId": "0eaa5978-d577-48fd-bc2a-68fb355b41e1",
          "transcriptionRequestedAt": "2026-01-15T09:30:00.000Z",
          "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
          },
          "youtubeEpisodeDetails": {
            "youtubeLink": "https://example.com",
            "youtubeMatchConfidence": 0,
            "youtubeViewCount": 0,
            "youtubeDataFetchedAt": "2026-01-15T09:30:00.000Z"
          },
          "applePodcastsUrl": "https://example.com"
        }
      ]
    }
  }
}

Request

Path parameters

podcastIdOrSlugstringrequired

Podengine ID, Apple ID, or slug

Query parameters

hasTranscriptboolean

When true, only return episodes with transcripts; false or omission does not filter by transcript availability.

skipnumbermin 0

Number of episodes to skip before returning this page.

limitnumber1 – 100

Maximum number of episodes to return in this page; defaults to 50, up to 100.

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired4 fields

optionsobjectrequired3 fields

hasTranscriptboolean

When true, only return episodes with transcripts; false or omission does not filter by transcript availability.

skipnumbermin 0

Number of episodes to skip before returning this page.

limitnumber1 – 100

Maximum number of episodes to return in this page; defaults to 50, up to 100.

totalEpisodesnumberrequired

totalTranscriptsnumberrequired

podcastWithEpisodesobjectrequired2 fields

podcastobjectrequired10 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

episodesarray of objectrequired23 fields

deepAnalysisRequestedAtdaterequirednullable

descriptionstringrequirednullable

durationSecondsnumberrequirednullable

enclosureUrlstringrequired

episodeIdstringrequireduuid

episodeGuestsAndHostsarray of objectrequirednullable3 fields

namestringrequired

typeenumrequired

hostguestunknownmentioned

imageUrlstringrequirednullable

episodeSlugstringrequired

episodeShortDescriptionstringrequirednullable

episodeSponsorsarray of stringrequirednullable

hasTranscriptbooleanrequired

hasVideobooleanrequired

Whether the podcast RSS feed declares a directly-downloadable video file for this episode. This does not include YouTube videos or Apple Podcasts HLS streams.

videoUrlstringrequirednullableurl

A direct, downloadable URL to the episode video file when hasVideo is true; otherwise null. HLS playlists and streaming-only sources are excluded.

imageUrlstringrequirednullable

episodeThumbnailRssUrlstringrequirednullable

podcastIdstringrequireduuid

podcastSlugstringrequired

publishedAtdaterequired

titlestringrequired

transcriptIdstringrequirednullableuuid

transcriptionRequestedAtdaterequirednullable

audienceEstimateobject5 fields

audienceDemographicsobjectrequirednullable5 fields