How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
PodcastIndex

PodcastIndex Episodes API

Find details about one or more episodes of a podcast or podcasts.

Documentation Provider Profile APIs.io OpenAPI GitHub

PodcastIndex Episodes API is one of 11 APIs that PodcastIndex publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Episodes. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 8 operations across 8 paths, and defines 93 schemas. It is described by OpenAPI 3.2.0, at version 1.12.1.

Requests are made against a single base URL, https://api.podcastindex.org/api/1.0.

8 operations 8 paths 93 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.12.1
Base URL
https://api.podcastindex.org/api/1.0
Authentication
API Key, API Key, API Key, API Key
Contact
https://podcastindex.org/
License
MIT
Terms of Service
View terms
Resource Areas
1

Authentication & Security 4

PodcastIndex Episodes API declares 4 security schemes for authenticating requests. An API key is passed in the header as User-Agent (User-Agent). An API key is passed in the header as X-Auth-Key (API-Key). An API key is passed in the header as X-Auth-Date (Date). An API key is passed in the header as Authorization (Authorization).

  • User-Agent — Please identify the system/product you are using to make this request. Example: SuperPodcastPlayer/1.3
  • API-Key — Your API key string Example: UXKCGDSYGUUEVQJSYDZH
  • Date — The current UTC unix epoch time as a string. 3 minute window. This value is an integer; round down if needed. The value shall not include a decimal point. Valu…
  • Authorization — A SHA-1 hash of the X-Auth-Key, the corresponding secret and the X-Auth-Date value concatenated as a string. The resulting hash should be encoded as a hexadeci…

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 8 GET. Each is listed below with its method, path, parameters, and response codes.

Episodes 8

Find details about one or more episodes of a podcast or podcasts.

GET
/episodes/byfeedid
By Feed ID
episodes/byfeedid 7 params → 200400401
GET
/episodes/byfeedurl
By Feed URL
episodes/byfeedurl 5 params → 200400401
GET
/episodes/bypodcastguid
By Podcast GUID
episodes/bypodcastguid 5 params → 200400401
GET
/episodes/byitunesid
By iTunes ID
episodes/byitunesid 6 params → 200400401
GET
/episodes/byid
By ID
episodes/byid 3 params → 200400401
GET
/episodes/byguid
By GUID
episodes/byguid 6 params → 200400401
GET
/episodes/live
Live
episodes/live 2 params → 200400401
GET
/episodes/random
Random
episodes/random 6 params → 200400401

Schemas 93

The contract defines 93 schemas that model the data the API accepts and returns. The most detailed are item_podcast (33 properties), episode_object (31 properties), item_itunesId (31 properties), liveitem_podcast (29 properties). Each schema is shown below with its type and property counts.

description_response
string
Description of the response
item_podcast_random
object
23 properties
url_socialInteract
string
The uri/url of the root post comment
transcript
object
This tag is used to link to a transcript or closed captions file. Multiple tags can be present for multiple transcript formats. Detailed file format informatio…
2 properties
startTime_live
integer
The time the livestream starts
suggested_v4v
stringnull
Suggested amount per second of playback to send. Unit is specific to the type.
explicit_episode
integer
Is feed or episode marked as explicit - 0: not marked explicit - 1: marked explicit
href
string
The url to a relevant resource of information about the person, such as a homepage or third-party profile platform. See the [podcast namespace spec](https://gi…
value
objectnull
Information for supporting the podcast via one of the "Value for Value" methods. May not be reported. Examples: - lightning value type: https://api.podcastinde…
2 properties
datePublishedPretty
string
The date and time the episode was published formatted as a human readable string. Note: uses the PodcastIndex server local time to do conversion.
protocol_socialInteract
string
The protocol in use for interacting with the comment root post. For the most up-to-date list of options, see https://github.com/Podcastindex-org/podcast-namesp…
itunesId_feed
integernull
The iTunes ID of this feed if there is one, and we know what it is.
title_feed
string
Name of the feed
model_v4v
object
Description of the method for providing "Value for Value" payments
3 properties
dead
integer
At some point, we give up trying to process a feed and mark it as dead. This is usually after 1000 errors without a successful pull/parse cycle. Once the feed…
language
string
The channel-level language specification of the feed. Languages accord with the [RSS Language Spec](https://www.rssboard.org/rss-language-codes).
dateCrawled
integer
The time this episode was found in the feed
title_soundbite
string
Name of the soundbite
fee_destination
booleannull
Indicates if destination is included due to a fee being charged. May not be reported.
podcastguid
string
The GUID from the podcast:guid tag in the feed. This value is a unique, global identifier for the podcast. See the namespace spec for [guid](https://github.com…
categories
object
An array of categories, where the index is the Category ID and the value is the Category Name. All Category numbers and names are returned by the categories/li…
destination_v4v
object
Destination for "Value for Value" payment.
7 properties
person
object
6 properties
chaptersUrl
stringnull
Link to the JSON file containing the episode chapters
guid_query
string
Value passed to request in the guid parameter.
type_v4v
string
Payment type
status_live
string
Status of the livestream
items_itunesId
array
List of episodes matching request
type_destination
string
Type of destination
priority_socialInteract
integer
When multiple socialInteract tags are present, this integer gives order of priority. A lower number means higher priority.
duplicateOf
integernull
The internal PodcastIndex.org Feed ID this feed duplicates. May be null except in podcasts/dead.
soundbites
arraynull
Soundbites for episode. May not be reported.
query_podcast_id_single
string
Single ID passed to request
episode_object
object
Episode data
31 properties
guid
string
The unique identifier for the episode
enclosureType
string
The Content-Type for the item specified by the enclosureUrl
name_person
string
The name of the person. See the [podcast namespace spec](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdperson) for more informatio…
episodes_random_array
array
List of episodes matching request
item_podcast
object
33 properties
contentLink
string
Link TODO
customValue
stringnull
A custom value to pass along with the payment. This is considered the value that belongs to the customKey. May not be reported. See the [podcast namespace spec…
group
string
The group the person's role is in. Value should be an official group within the Podcast Taxonomy Project [list](https://github.com/Podcastindex-org/podcast-nam…
socialInteract_item
object
5 properties
url_feed
string
Current feed URL
destinations_v4v
array
List of destinations where "Value for Value" payments should be sent.
items_live
array
List of episodes matching request
episodeType
stringnull
The type of episode. May be null for liveItem.
accountId_socialInteract
string
The account id (on the commenting platform) of the account that created this root post.
image_episode
string
The item-level image for the episode
split_destination
integer
Share of payment the destination should receive
enclosureLength
integer
The length of the item specified by the enclosureUrl in bytes
persons
arraynull
List of people with an interest in this episode. May not be reported. See the [podcast namespace spec](https://github.com/Podcastindex-org/podcast-namespace/bl…
soundbite
objectnull
Soundbite for episode. May not be reported.
3 properties
role
string
Used to identify what role the person serves on the show or episode. Value should be an official role within the Podcast Taxonomy Project [list](https://github…
id_episode
integer
The internal PodcastIndex.org episode ID.
feedid_query
string
Value passed to request in the feedid parameter
address_destination
string
Address of node to receive payment
socialInteract
arraynull
List the social interact data found in the podcast feed. May not be reported. See the [podcast namespace spec](https://github.com/Podcastindex-org/podcast-name…
method_v4v
string
Method for sending payment
url_query
string
Value passed to request in the url field
item_podcast_live
object
18 properties
episode_number
integernull
Episode number
datePublished
integer
The date and time the episode was published
duration
integernull
The estimated length of the item specified by the enclosureUrl in seconds. Will be null for liveItem.
query_url
object
Object containing the input query data
1 property
endTime_live
integer
The time the livestream ends
season
integernull
Season number. May be null for liveItem.
description_episode
string
The item-level description of the episode. Uses the longer of the possible fields in the feed: , and
transcriptUrl
stringnull
Link to the file containing the episode transcript Note: in most use cases, the transcripts value should be used instead
transcripts
arraynull
List of transcripts for the episode. May not be reported.
count
integer
Number of items returned in request
id_person
integer
The internal PodcastIndex.org person ID.
feedurl_query
string
Value passed to request in the feedurl parameter. If no feedurl passed, value will be null.
liveitem_podcast
object
29 properties
img
string
URL to a picture or avatar of the person. See the [podcast namespace spec](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdperson) f…
item_itunesId
object
31 properties
duration_soundbite
integer
The length to play the item specified by the enclosureUrl
max
integernull
Value of max parameter passed to request.
status
string
Indicates API request status
startTime
integer
The time where the soundbite begins in the item specified by the enclosureUrl
id_query
string
Value passed to request in the id field
enclosureUrl
string
URL/link to the episode file
name_destination
string
Name for the destination
customKey
stringnull
The name of a custom record key to send along with the payment. May not be reported. See the [podcast namespace spec](https://github.com/Podcastindex-org/podca…
items_podcast
array
List of episodes matching request
liveItems_podcast
array
List of live episodes for feed
link_feed
string
The channel-level link in the feed
image_feed
string
The channel-level image element.
query_podcast_id_multiple
array
IDs passed to request
accountUrl_socialInteract
string
The public url (on the commenting platform) of the account that created this root post.
imageUrlHash
integer
A CRC32 hash of the image URL with the protocol (http://, https://) removed. 64bit integer.
id_feed
integer
The internal PodcastIndex.org Feed ID.
feedImageUrlHash
integer
A CRC32 hash of the feedImage URL with the protocol (http://, https://) removed.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

podcastindex-episodes-api-openapi.yml Raw ↑

Other APIs PodcastIndex publishes across the network.

PodcastIndex Add API
AE Profile APIs.io
PodcastIndex Apple Replacement API
AE Profile APIs.io
PodcastIndex Categories API
AE Profile APIs.io
PodcastIndex Hub API
AE Profile APIs.io
PodcastIndex Podcasts API
AE Profile APIs.io
PodcastIndex Recent API
AE Profile APIs.io
PodcastIndex Search API
AE Profile APIs.io
PodcastIndex Static Data API
AE Profile APIs.io
PodcastIndex Stats API
AE Profile APIs.io
PodcastIndex Value API
AE Profile APIs.io
#Episodes
← Back to P APIs
API Details
ID
podcastindex:podcastindex-episodes-api
Base URL
https://api.podcastindex.org/api/1.0
Docs
https://podcastindex-org.github.io/docs-api/
Provider
PodcastIndex
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=podcastindex-episodes-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/podcastindex-episodes-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of PodcastIndex Episodes API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.