{"uid":"cap_GsNlvq8jNud3VaFH5PjDU","slug":"particle-pro-episode-lookup-64be5c10","name":"Particle Pro Episode Lookup","description":"Look up episodes by external identifier. Resolves one or more external episode identifiers to Particle episodes.","url":"https://api.particle.pro/v1/podcasts/episodes/lookup?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["identifier"],"properties":{"platform":{"type":"string","description":"What kind of identifier you are resolving. Optional when every identifier is a link: a Spotify, Apple Podcasts or YouTube episode URL, or a spotify:episode: URI, is always resolved by the platform it points to. Needed for bare identifiers: 'apple' (alias 'itunes') resolves Apple Podcasts episode IDs — the ?i= value in an Apple Podcasts URL. 'spotify' resolves Spotify episode IDs. 'youtube' resolves YouTube video IDs against the videos discovered for each episode. 'guid' resolves the episode's RSS guid, the identifier carried in the publisher's own feed and the one most podcast tooling keys on. 'podcastindex' resolves a PodcastIndex episode ID. 'megaphone', 'omny', 'acast' and 'art19' resolve a hosting platform's own episode ID, read from the episode's audio URL. Platform slugs must be ones reported on external-links responses; 'rss' is not accepted here because a feed URL identifies a show, not an episode."},"identifier":{"type":"array","items":{"type":"string"},"description":"One or more episode identifiers or 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. Spotify, Apple Podcasts and YouTube episode links are understood in their common forms (share links with a locale or ?si= token, embed URLs, youtu.be, /live/, /shorts/). guid, podcastindex and hosting-platform values are used exactly as given — a guid is whatever string the feed carries, which is often itself a URL, so it is never read as a link. The identifier is echoed back exactly as supplied, not normalized."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CyOfDzwOz6SjJzS_A3MKI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves one or more external episode identifiers (Apple Podcasts, YouTube, RSS GUID, PodcastIndex, Megaphone, Omny, Acast, Art19) to Particle Pro podcast episodes","exampleAgentPrompt":"Look up the podcast episode with Apple Podcasts episode ID 1000672345678 on Particle Pro and give me the matching episode details.","exampleUseCases":[{"title":"Resolve Apple Podcasts episode to Particle","prompt":"I have an Apple Podcasts episode URL — the ?i= value is 1000623456789 — can you look it up on Particle Pro to get the episode record?"},{"title":"Batch resolve YouTube podcast clips","prompt":"I have these three YouTube video IDs from podcast episodes: dQw4w9WgXcQ, abc123XYZ, and xyz789ABC — can you resolve all of them to their Particle Pro episodes at once?"},{"title":"Cross-reference RSS GUID for episode data","prompt":"Can you find the Particle episode that matches this RSS GUID from a podcast feed: 'https://example.com/podcast/episodes/42-my-episode-slug'? Use guid as the platform."}],"resultDescription":"A list of Particle episode records corresponding to the supplied external identifiers, echoing back the original identifiers as supplied alongside any matched Particle episode data.","failureModes":["Unrecognized platform slug returns an error — only supported platforms (apple, itunes, youtube, guid, podcastindex, megaphone, omny, acast, art19) are accepted","Identifier not found in Particle's index returns an empty or null match for that entry","Exceeding 100 identifiers per call results in an error","Using 'rss' as the platform is explicitly not accepted since feed URLs identify shows, not episodes","Malformed YouTube URL may fail to parse the video ID","Payment failure (x402 protocol) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you have an external episode identifier from a major podcast platform or RSS feed and need to map it to a Particle Pro episode record — especially for cross-platform episode resolution, batch lookups of up to 100 episodes at once, or when integrating with Apple Podcasts, YouTube, or RSS-based tooling. Prefer this over generic podcast search when you have a precise identifier rather than a keyword query.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:05:32.140Z","isFirstParty":false,"canonicalSlug":"particle-pro-episode-lookup-64be5c10"}