Episode Details

GET https://api.podengine.ai/api/v1/episodes/:episodeId/details

Get the details of an episode

Example request

curl -X GET "https://api.podengine.ai/api/v1/episodes/:episodeId/details" \
  -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/episodes/:episodeId/details", 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/episodes/:episodeId/details", 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/episodes/:episodeId/details");
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/episodes/:episodeId/details", 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.episodes.getEpisodeDetailsById({
  episodeId: 'cbd08a7c-b936-4ee8-87d1-12df08da1c9f',
});

console.log(data);

import os

from podengine import PodEngine

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

data = pe.episodes.get_episode_details_by_id(
    episode_id="cbd08a7c-b936-4ee8-87d1-12df08da1c9f",
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "episode": {
      "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,
        "estimatedMonthlyListenersBucket": "0-1K",
        "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

episodeIdstringrequireduuid

Pod Engine UUID of the episode.

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired1 field

episodeobjectrequired23 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

audienceEstimateobject6 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

youtubeEpisodeDetailsobjectrequirednullable4 fields

youtubeLinkstringrequiredurl

youtubeMatchConfidencenumberrequired

youtubeViewCountnumberrequirednullable

youtubeDataFetchedAtdaterequirednullable

applePodcastsUrlstringrequirednullableurl