{"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","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","platform"],"properties":{"platform":{"type":"string","description":"What kind of identifier you are resolving. 'apple' (alias 'itunes') resolves Apple Podcasts episode IDs — the ?i= value in an Apple Podcasts URL. '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 to resolve. Pass a comma-separated list to look up many at once (max 100 per call). A full platform URL is accepted in place of a bare identifier and the ID is parsed out of it: for apple/itunes an Apple Podcasts episode URL (the ?i= value); for youtube a watch?v=, youtu.be/, /live/, /shorts/ or /embed/ URL. guid, podcastindex and hosting-platform values are used as given — a guid is whatever string the feed carries, which is often itself a URL, so it is never parsed. 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-09-14T00:57:46.571Z","isFirstParty":false}