{"uid":"cap_4gMjacwn8DmjUcEYG4zY1","slug":"tanod-podcast-search-47a54b5c","name":"Tanod Podcast Search","description":"Podcast search: a podcast name or Apple Podcasts link to its RSS feed URL, show data and latest episodes (utilpeek by Tanod). Use when an agent must find a podcast's RSS feed URL and latest episodes from a show name or Apple link.","url":"https://tanod.dev/v1/podcast/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":3,"maximum":10,"minimum":1,"description":"Most shows to return, 1-10 (default 3); the first match is the best one and carries the episodes."},"query":{"type":"string","maxLength":300,"minLength":1,"description":"A podcast name (such as Lex Fridman Podcast) or an Apple Podcasts show link (podcasts.apple.com/.../id<digits>). Spotify and YouTube links are refused."},"country":{"type":"string","default":"us","pattern":"^[a-zA-Z]{2}$","description":"Apple storefront as a two-letter country code (default us)."},"episodes":{"type":"integer","default":5,"maximum":25,"minimum":0,"description":"Latest episodes of the first match to read from its feed, 0-25 (default 5; 0 skips the feed)."}}},"responseSchema":{"type":"json","example":{"query":"Lex Fridman Podcast","source":"Apple Podcasts directory (iTunes Search API)","country":"us","matches":[{"name":"Lex Fridman Podcast","genre":"Technology","author":"Lex Fridman","artwork":"https://is1-ssl.mzstatic.com/image/thumb/Podcasts115/v4/3e/e3/9c/mza_16657851278549137484.png/600x600bb.jpg","country":"USA","apple_id":"1434243584","explicit":false,"feed_url":"https://lexfridman.com/feed/podcast/","apple_url":"https://podcasts.apple.com/us/podcast/lex-fridman-podcast/id1434243584?uo=4","episode_count":502,"latest_release":"2026-09-17T00:40:00Z"}],"episodes":[{"guid":"https://lexfridman.com/?p=6506","link":"https://lexfridman.com/dhh-2/","title":"#501 – DHH: Future of Programming, AI, Agentic Engineering, Vibe Coding & Linux","season":null,"episode":null,"summary":"DHH is the creator of Ruby on Rails, Omarchy Linux, CTO of 37signals, and a racecar driver.","enclosure":{"url":"https://media.blubrry.com/takeituneasy/ins.blubrry.com/takeituneasy/lex_ai_dhh_2.mp3","type":"audio/mpeg","length":249955445},"published":"2026-08-26T21:47:04Z","duration_s":19317,"episode_type":"full"}],"operation":"podcast-search","episodes_of":"https://lexfridman.com/feed/podcast/","episodes_error":null,"untrusted_content":true,"episode_count_in_feed":502}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LqPtg5nUFul9NklOo_lyK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Apple Podcasts for a show by name or Apple Podcasts link and returns metadata plus the latest episodes from the show's RSS feed","exampleAgentPrompt":"Search Apple Podcasts for 'Lex Fridman Podcast' in the US storefront and give me the show details along with the 5 most recent episodes including their titles, summaries, and audio links.","exampleUseCases":[{"title":"Latest episode discovery for a show","prompt":"Find me the 10 most recent episodes of 'Hardcore History' by Dan Carlin on Apple Podcasts — I want the titles, dates, and audio URLs so I can pick one to listen to."},{"title":"RSS feed URL retrieval for automation","prompt":"I need the RSS feed URL for 'The Tim Ferriss Show' podcast — search Apple Podcasts US and just return the feed link without pulling any episodes."},{"title":"International podcast catalog lookup","prompt":"Look up the podcast 'Fest & Flauschig' on Apple Podcasts in the German storefront and show me its metadata and the 3 latest episodes."}],"resultDescription":"Returns a JSON object with the search query, source, country, and an array of matching podcast shows (name, genre, author, artwork URL, Apple ID, feed URL, episode count, latest release date, Apple Podcasts URL). For the top match, also returns an array of the latest episodes from the RSS feed, each with title, summary, audio enclosure URL and type, published date, duration in seconds, and episode type. Includes an episodes_error field if the feed could not be fetched.","failureModes":["Podcast not found in Apple directory returns empty matches array","Spotify or YouTube links are refused with an error","RSS feed unreachable causes episodes_error to be non-null while show metadata still returns","Country code not recognized defaults to US or returns no results","Query exceeding 300 characters is rejected by schema validation","Episode count outside 0-25 range is clamped or rejected"],"whenToPreferThis":"Use this endpoint when you need to search the Apple Podcasts catalog by show name or Apple Podcasts URL and retrieve both show-level metadata and recent episode data in a single call. Prefer it over generic web scraping when you need structured data like the RSS feed URL, Apple Podcasts ID, artwork, and episode audio links directly. Not suitable for Spotify or YouTube podcast lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T00:30:14.763Z","isFirstParty":false,"canonicalSlug":"tanod-podcast-search-47a54b5c"}