{"uid":"cap_fwXvoou2cgQmkMUIygi4g","slug":"particle-pro-podcast-lookup-by-external-platform-id-22b934aa","name":"Particle Pro Podcast Lookup by External Platform ID","description":"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 RSS feed URLs via platform=rss — to Particle podcasts.","url":"https://api.particle.pro/v1/podcasts/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":"External platform slug (e.g. 'apple', 'spotify', 'youtube'). Must be one of the slugs reported on /v1/podcasts/{id}/external-links responses, or one of the in-house aliases: 'itunes' (alias for 'apple') and 'rss' (match against the canonical podcast feed URL)."},"identifier":{"type":"array","items":{"type":"string"},"description":"One or more platform-native identifiers to resolve. Pass a comma-separated list to look up many at once (max 100 per call)."}}}},"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_y-CzL9HLU6v0p8Cc6dlS0","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 external platform identifiers (Apple Podcasts, Spotify, YouTube, RSS) to Particle podcast records","exampleAgentPrompt":"Can you look up the podcast with Spotify show ID '3jEBrMqFSjbBrLqAlhiLLF' on Particle Pro and get me its Particle podcast record?","exampleUseCases":[{"title":"Resolve Apple Podcasts ID to Particle","prompt":"I have an Apple Podcasts collection ID — 1200361736 — can you look it up on Particle Pro and tell me what podcast that corresponds to in their system?"},{"title":"Batch RSS feed URL resolution","prompt":"I have three RSS feed URLs for podcasts and I want to find their corresponding Particle podcast profiles — can you look up all three at once using the rss platform option?"},{"title":"Cross-platform podcast enrichment","prompt":"I'm building a podcast list and I've got a bunch of YouTube channel IDs. Can you resolve them to Particle podcasts so I can pull richer metadata for each one?"}],"resultDescription":"Returns one or more Particle podcast objects matched to the provided external platform identifiers, including Particle's internal podcast ID and associated metadata for each resolved podcast.","failureModes":["Identifier not found on the specified platform returns empty or null result","Invalid or unsupported platform slug returns an error","Exceeding the 100-identifier-per-call limit causes a validation error","Malformed RSS URL when using platform=rss may fail to match","Rate limiting or payment failure ($0.01 USDC per call) blocks the request"],"whenToPreferThis":"Use this endpoint when you have an external podcast identifier (Apple Podcasts, Spotify, YouTube, or an RSS feed URL) and need to map it to a Particle podcast record for further querying — such as fetching related shows, advertiser data, or political bias metrics. Prefer this over a general search when you already know the exact platform-native ID.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:28.004Z","isFirstParty":false}