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.
Request
- Base URL: https://api.particle.pro
- URL: https://api.particle.pro/v1/podcasts/lookup
- Auth: one of:
- API key in header X-API-Key
- HTTP bearer
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).
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.
[ "1535809341", "https://open.spotify.com/show/2dR1MUZEHCOnz1LVfNac0j" ]
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.