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 Value API

The podcast's "Value for Value" information

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

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

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

5 operations 5 paths 37 schemas 4 GET1 POST

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 Value 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 5

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

Value 5

The podcast's "Value for Value" information

GET
/value/byfeedid
By Feed ID
value/byfeedid 2 params → 200400401
GET
/value/byfeedurl
By Feed URL
value/byfeedurl 2 params → 200400401
GET
/value/bypodcastguid
By Feed GUID
value/bypodcastguid 2 params → 200400401
GET
/value/byepisodeguid
By Episode GUID
value/byepisodeguid 3 params → 200400401
POST
/value/batch/byepisodeguid
Batch By Episode GUID
value/batch/byepisodeguid 1 param body → 200400401

Schemas 37

The contract defines 37 schemas that model the data the API accepts and returns. The most detailed are destination_v4v (7 properties), value_byepisodeguid_batch (6 properties), value_byepisodeguid (4 properties), model_v4v (3 properties). Each schema is shown below with its type and property counts.

description_response
string
Description of the response
suggested_v4v
stringnull
Suggested amount per second of playback to send. Unit is specific to the type.
id_query_guid
integer
The Podcast Index Id of the podcast GUID passed as an argument to the request
query_episodeguid
string
The value of the episodeguid argument passed to the request.
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
type_destination
string
Type of destination
guids
object
The podcastguid and episodeguid values passed to the request.
query_podcastguid
string
The value of the podcastguid argument passed to the request.
address_destination
string
Address of node to receive payment
title_feed
string
Name of the feed
guid
string
The unique identifier for the episode
method_v4v
string
Method for sending payment
model_v4v
object
Description of the method for providing "Value for Value" payments
3 properties
value_guid_list
array
List of value blocks
url_query
string
Value passed to request in the url field
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…
status
string
Indicates API request status
query_guids
object
Object containing the input query data
1 property
value_batch_byepisodeguid
object
JSON data where key is the podcastguid and value is a list of episodeguid values.
title_episode
string
Name of the episode
found
integer
Number of value data returned.
fee_destination
booleannull
Indicates if destination is included due to a fee being charged. May not be reported.
value_byepisodeguid
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…
4 properties
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…
destination_v4v
object
Destination for "Value for Value" payment.
7 properties
query_id
object
Object containing the input query data
1 property
destinations_v4v
array
List of destinations where "Value for Value" payments should be sent.
query_byepisodeguid
object
Object containing the input query data
2 properties
id_query
string
Value passed to request in the id field
name_destination
string
Name for the destination
query_url
object
Object containing the input query data
1 property
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…
query_guid_id
object
Object containing the input query data
1 property
split_destination
integer
Share of payment the destination should receive
type_v4v
string
Payment type
value_byepisodeguid_batch
object
Information for supporting the podcast via one of the "Value for Value" methods.
6 properties
allfound
boolean
Indicates if data was found for all podcastguid and episodeguid values.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

podcastindex-value-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 Static Data API
PodcastIndex Stats API
Where this information came from

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