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

PodcastIndex Static Data API

The Static Data API from PodcastIndex — 11 operation(s) for static data.

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

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

This API exposes 11 operations across 11 paths, and defines 76 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.

11 operations 11 paths 76 schemas 11 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
License
Terms of Service
Resource Areas
1

Authentication & Security 4

PodcastIndex Static Data 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 11

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

Static Data 11
GET
/static/stats/daily_counts.json
Stats Daily Counts
daily_counts.json → 200400404
GET
/static/stats/hourly_counts.json
Stats Hourly Counts
hourly_counts.json → 200400404
GET
/static/stats/chart-data.json
v4v Sats
chart-data.json → 200400404
GET
/static/stats/v4vmusic.json
v4v Music Chart JSON
v4vmusic.json → 200400404
GET
/static/stats/v4vmusic.opml
v4v Music Chart OPML
v4vmusic.opml → 200400404
GET
/static/stats/v4vmusic.rss
v4v Music Chart RSS
v4vmusic.rss → 200400404
GET
/static/tracking/current
Current
current → 200400404
GET
/static/tracking/feedValueBlocks
Feed Value Blocks
feedValueBlocks.json → 200400404
GET
/static/tracking/episodeValueBlocks
Episode Value Blocks
episodeValueBlocks.json → 200400404
GET
/static/public/podcastindex_dead_feeds.csv
Dead Feeds
podcastindex_dead_feeds.csv → 200400404
GET
/static/public/podcastindex_feeds.db.tgz
Feeds Database
podcastindex_feeds_db.tgz → 200400404

Schemas 76

The contract defines 76 schemas that model the data the API accepts and returns. The most detailed are items_data_obj (12 properties), destination_v4v (7 properties), feeds_data_obj (7 properties), data_static (4 properties). Each schema is shown below with its type and property counts.

feedsWithTranscripts
integer
Podcast feeds with a [podcast:transcript](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdtranscript) tag in at least 1 episode.
suggested_v4v
stringnull
Suggested amount per second of playback to send. Unit is specific to the type.
feedsWithNewEpisodes90days
integer
Podcast feeds with a new episode released in the last 90 days.
feedsWithChapters
integer
Podcast feeds with a [podcast:chapters](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdchapters) tag in at least 1 episode.
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
newEpisodes14days
integer
Podcast feeds with a new episode containing a released in the last 14 days.
data_static
object
Object containing the recent data
4 properties
feedsWithNewEpisodes7days
integer
Podcast feeds with a new episode released in the last 7 days.
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
since
integernull
Value of since parameter passed to request.
model_v4v
object
Description of the method for providing "Value for Value" payments
3 properties
valueCreatedOn
integer
The time this feed's value data added. Will be 0 if no value data.
position
integer
Position in data
language
string
The channel-level language specification of the feed. Languages accord with the [RSS Language Spec](https://www.rssboard.org/rss-language-codes).
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…
feeds_data_obj
object
7 properties
destination_v4v
object
Destination for "Value for Value" payment.
7 properties
type_v4v
string
Payment type
feedsWithNewEpisodes14days
integer
Podcast feeds with a new episode released in the last 14 days.
items_data_obj
object
12 properties
type_destination
string
Type of destination
guid
string
The unique identifier for the episode
enclosureType
string
The Content-Type for the item specified by the enclosureUrl
feedsWithValueBlocks
integer
Podcast feeds with a [podcast:value](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdvalue) tag in at least 1 episode.
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…
feedsWithNewEpisodes10days
integer
Podcast feeds with a new episode released in the last 10 days.
feedsWithFundingTag
integer
Podcast feeds with a [podcast:funding](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdfunding) tag in at least 1 episode.
destinations_v4v
array
List of destinations where "Value for Value" payments should be sent.
newEpisodes10days
integer
Podcast feeds with a new episode containing a released in the last 10 days.
feedsWithMediumMusic
integer
Podcast feeds with a [podcast:medium](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdmedium) tag with a value of music.
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
split_destination
integer
Share of payment the destination should receive
feedsWithNewEpisodes3days
integer
Podcast feeds with a new episode released in the last 3 days.
enclosureLength
integer
The length of the item specified by the enclosureUrl in bytes
paidFeedsWithNewEpisodes30days
integer
Podcast feeds with a new episode containing a [podcast:value](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdvalue) block released…
paidFeedsWithNewEpisodes3days
integer
Podcast feeds with a new episode containing a [podcast:value](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdvalue) block released…
newEpisodes90days
integer
Podcast feeds with a new episode containing a released in the last 90 days.
id_episode
integer
The internal PodcastIndex.org episode ID.
address_destination
string
Address of node to receive payment
items_data
array
List of recent episode item data
episodeAdded
integer
The time the episode was added to the index
newEpisodes60days
integer
Podcast feeds with a new episode containing a released in the last 60 days.
method_v4v
string
Method for sending payment
feedCount
integer
Number of items in the feeds returned in request
feedsWithMediumVideo
integer
Podcast feeds with a [podcast:medium](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdmedium) tag with a value of video.
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.
paidFeedsWithNewEpisodes10days
integer
Podcast feeds with a new episode containing a [podcast:value](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdvalue) block released…
feedCountTotal
integer
Total podcast feeds in the index.
feedsWithNewEpisodes60days
integer
Podcast feeds with a new episode released in the last 60 days.
feedsWithNewEpisodes30days
integer
Podcast feeds with a new episode released in the last 30 days.
paidFeedsWithNewEpisodes7days
integer
Podcast feeds with a new episode containing a [podcast:value](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdvalue) block released…
description_episode
string
The item-level description of the episode. Uses the longer of the possible fields in the feed: , and
newEpisodes3days
integer
Podcast feeds with a new episode containing a released in the last 3 days.
episodesWithChapters
integer
Number of episodes with [podcast:chapters](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdchapters)
paidFeedsWithNewEpisodes90days
integer
Podcast feeds with a new episode containing a [podcast:value](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdvalue) block released…
paidFeedsWithNewEpisodes14days
integer
Podcast feeds with a new episode containing a [podcast:value](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdvalue) block released…
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
description_feed
string
The channel-level description Uses the longer of the possible fields in the feed: , and
episodeCountTotal
integer
Total individual podcast episodes in the index.
newEpisodes30days
integer
Podcast feeds with a new episode containing a released in the last 30 days.
name_destination
string
Name for the destination
episodesWithTranscripts
integer
Episodes with a [podcast:transcript](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdtranscript) tag.
enclosureUrl
string
URL/link to the episode file
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…
paidFeedsWithNewEpisodes60days
integer
Podcast feeds with a new episode containing a [podcast:value](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.mdvalue) block released…
newEpisodes7days
integer
Podcast feeds with a new episode containing a released in the last 7 days.
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.

Source

podcastindex-static-data-api-openapi.yml Raw ↑

Other APIs PodcastIndex publishes across the network.

PodcastIndex Add API
PodcastIndex Apple Replacement API
PodcastIndex Categories API
PodcastIndex Episodes API
PodcastIndex Hub API
PodcastIndex Podcasts API
PodcastIndex Recent API
PodcastIndex Search API
PodcastIndex Stats API
PodcastIndex Value API
Where this information came from

This is an independent, third-party profile of PodcastIndex Static Data 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.