PodcastIndex Recent 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 6
Across 6 paths, the API surfaces 6 operations — 6 GET. Each is listed below with its method, path, parameters, and response codes.
Recent 6
Find recent additions to the index
GET
/recent/episodes
Episodes
recent/episodes5 params→ 200400401
GET
/recent/feeds
Feeds
recent/feeds6 params→ 200400401
GET
/recent/newfeeds
New Feeds
recent/newfeeds5 params→ 200400401
GET
/recent/newvaluefeeds
New Value Feeds
recent/newvaluefeeds3 params→ 200400401
GET
/recent/data
Recent Data
recent/data3 params→ 200400401
GET
/recent/soundbites
Soundbites
recent/soundbites2 params→ 200400401
Schemas 56
The contract defines 56 schemas that model the data the API accepts and returns. The most detailed are item_podcast_recent (21 properties), items_data_obj (12 properties), feeds_data_obj (7 properties), data (3 properties). Each schema is shown below with its type and property counts.
description_response
string
Description of the response
author
string
The channel-level author element. Usually iTunes specific, but could be from another namespace if not present.
data
object
Object containing the recent data
3 properties
explicit_episode
integer
Is feed or episode marked as explicit - 0: not marked explicit - 1: marked explicit
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.
title_feed
string
Name of the feed
itunesId_feed
integernull
The iTunes ID of this feed if there is one, and we know what it is.
since
integernull
Value of since parameter passed to request.
newestItemPublishTime
integer
The time the most recent episode in the feed was published. Note: some endpoints use newestItemPubdate while others use newestItemPublishTime. They return the…
position
integer
Position in data
status_feed
string
Status of feed after being added to index
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
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…
contentHash
string
Hash of the entire feed body
feeds_data_obj
object
7 properties
timeAdded
integer
The date and time the feed was added to the index
items_recent
array
List of episodes matching request
items_data_obj
object
12 properties
guid
string
The unique identifier for the episode
enclosureType
string
The Content-Type for the item specified by the enclosureUrl
feeds_recent
array
List of feeds matching request
oldestItemPublishTime
integer
The date and time the oldest episode in the feed/index
episodeType
stringnull
The type of episode. May be null for liveItem.
image_episode
string
The item-level image for the episode
feeds_data
array
List of recent feed data
enclosureLength
integer
The length of the item specified by the enclosureUrl in bytes
trendScore
integer
The ranking for how the podcast is trending in the index
id_episode
integer
The internal PodcastIndex.org episode ID.
items_data
array
List of recent episode item data
nextSince
integer
Value to pass as since parameter to get next batch of data
episodeAdded
integer
The time the episode was added to the index
feedCount
integer
Number of items in the feeds returned in request
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.
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
feeds_recent_value
array
List of feeds matching request
count
integer
Number of items returned in request
item_podcast_recent
object
21 properties
duration_soundbite
integer
The length to play the item specified by the enclosureUrl
itemCount
integer
Number of items in the items returned in request
max
integernull
Value of max parameter passed to request.
status
string
Indicates API request status
items_soundbites
array
List of soundbites matching request
title_episode
string
Name of the episode
description_feed
string
The channel-level description Uses the longer of the possible fields in the feed: , and
startTime
integer
The time where the soundbite begins in the item specified by the enclosureUrl
enclosureUrl
string
URL/link to the episode file
feeds_recent_new
array
List of feeds matching request
link_feed
string
The channel-level link in the feed
image_feed
string
The channel-level image element.
url_feed
string
Current feed URL
id_feed
integer
The internal PodcastIndex.org Feed ID.
Specification
The full machine-readable OpenAPI contract behind this narrative.
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.
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 Recent 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.
