curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/lookup?identifier=1535809341%2Chttps%3A%2F%2Fopen.spotify.com%2Fshow%2F2dR1MUZEHCOnz1LVfNac0j"{
"results": [
{
"identifier": "<string>",
"podcast": {
"id": "<string>",
"title": "<string>",
"best_rank": {
"captured_at": "2023-11-07T05:31:56Z",
"chart_type": "top_podcasts",
"rank": 123,
"source": "apple",
"category_slug": "<string>",
"country": "<string>"
},
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>"
}
}
]
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Look up podcasts by external platform identifier
Resolves one or more external platform identifiers (Apple Podcasts collection IDs, Spotify show IDs, YouTube channel IDs, …) or show links — or RSS feed URLs via platform=rss — to Particle podcasts. Paste a show’s Apple Podcasts, Spotify or YouTube URL, its page on any other platform, or its feed URL as it is and it is resolved by what it points to; platform is then optional and links from different platforms may share a call. Bare identifiers need platform. Pass a comma-separated list (up to 100 per call). Each result echoes the input identifier alongside the matched podcast; unresolved identifiers omit the podcast field entirely so bulk callers can correlate inputs and outputs by key presence without doing a separate join. Use this when you already hold platform-native IDs and want a deterministic mapping; for fuzzy name search use GET /v1/podcasts/search.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/lookup?identifier=1535809341%2Chttps%3A%2F%2Fopen.spotify.com%2Fshow%2F2dR1MUZEHCOnz1LVfNac0j"{
"results": [
{
"identifier": "<string>",
"podcast": {
"id": "<string>",
"title": "<string>",
"best_rank": {
"captured_at": "2023-11-07T05:31:56Z",
"chart_type": "top_podcasts",
"rank": 123,
"source": "apple",
"category_slug": "<string>",
"country": "<string>"
},
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>"
}
}
]
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
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).
"apple"
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.
1 - 100 elements[
"1535809341",
"https://open.spotify.com/show/2dR1MUZEHCOnz1LVfNac0j"
]
Response
OK
One result per unique input identifier, in request order
Show child attributes
Show child attributes
Was this page helpful?