Skip to main content
GET
Prefer the terminal? This endpoint is also a command in the Particle CLI: pick Particle CLI in the request example’s language menu. Install the Particle CLI.

Authorizations

X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Query Parameters

platform
string

External platform slug (e.g. 'apple', 'spotify', 'youtube'), case-insensitive. Optional when every identifier is a link: a show's page on any platform listed on /v1/podcasts/{id}/external-links responses (Apple Podcasts, Spotify, YouTube, …), a spotify:show: URI, or the show's feed or website URL is resolved by what it points to. Needed for bare identifiers: one of the slugs reported on external-links responses, or one of the in-house aliases 'itunes' (alias for 'apple'), 'x' (alias for 'twitter') and 'rss' (match against the canonical podcast feed URL).

Example:

"apple"

identifier
string[] | null
required

One or more platform-native identifiers or show links to resolve. Pass a comma-separated list to look up many at once (max 100 per call); links from different platforms may be mixed. Matching ignores case, so 'thepeelpod' finds the podcast whose X handle is 'ThePeelPod'; URLs ('rss', 'website') are the exception and match exactly.

Required array length: 1 - 100 elements
Example:

Response

OK

results
object[] | null
required

One result per unique input identifier, in request order