Catalog/media-podcast-episodes

Data

Podcast episodes from RSS API

List a podcast's episodes by fetching and parsing its RSS feed — either a direct feedUrl or resolved from an Apple iTunes collectionId (keyless) — normalized to title, publish date, duration, audio enclosure URL, episode/season numbers, and description. Answers 'list episodes of a podcast','latest episode of a show','get podcast audio URLs','episode durations and dates'.

Price$0.01per request
MethodPOST
Route/v1/data/media-podcast-episodes
StatusLive
MIME typeapplication/json
Rate limit60/minute
Cache3600s public
mediapodcastepisodesrssfeedaudioitunesentertainment
API URLhttps://x402.hexl.dev/v1/data/media-podcast-episodes
Integration docs
Example request
{
  "collectionId": "201671138",
  "limit": 2
}
Example response
{
  "feedUrl": "https://www.thisamericanlife.org/podcast/rss.xml",
  "podcast": {
    "title": "This American Life",
    "author": "This American Life",
    "description": "Each week we choose a theme.",
    "link": "https://www.thisamericanlife.org",
    "language": "en",
    "genre": "Society & Culture"
  },
  "episodeCount": 2,
  "episodes": [
    {
      "title": "853: The Wing of the Marble Hall",
      "published": "Sun, 26 May 2024 10:00:00 GMT",
      "publishedIso": "2024-05-26T10:00:00.000Z",
      "durationSeconds": 3540,
      "episode": 853,
      "season": null,
      "episodeType": "full",
      "explicit": false,
      "audioUrl": "https://cdn.example/853.mp3",
      "audioType": "audio/mpeg",
      "fileSizeBytes": 48000000,
      "guid": "85300",
      "description": "This week's stories."
    }
  ]
}
Input schema
{
  "type": "object",
  "required": [],
  "properties": {
    "feedUrl": {
      "type": "string",
      "examples": [
        "https://www.thisamericanlife.org/podcast/rss.xml"
      ]
    },
    "collectionId": {
      "type": "string",
      "examples": [
        "201671138"
      ]
    },
    "limit": {
      "type": "number",
      "default": 25,
      "examples": [
        10
      ]
    }
  }
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}