{"uid":"cap_Geb3p931ZSGH_DXXIhi8U","slug":"particle-pro-list-podcast-episodes-41cd1262","name":"Particle Pro – List Podcast Episodes","description":"List episodes for a podcast. Returns a paginated list of episodes for a specific podcast, identified by slug (e.g., 'all-in') or ID.","url":"https://api.particle.pro/v1/podcasts/:id/episodes","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"},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID"}}},"queryParams":{"type":"object","properties":{"q":{"type":"string","description":"Filter to episodes whose title contains this text, case-insensitively. Matches the episode TITLE only — to search what is said inside episodes, use /v1/podcasts/episodes/search with podcast_id."},"limit":{"type":"integer","format":"int64","description":"Results per page"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"published_after":{"type":"string","description":"Only episodes published after this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)"},"published_before":{"type":"string","description":"Only episodes published before this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DdD73kzHhxC0minNuisga","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated list of episodes for a specific podcast, filterable by title keyword and date range, identified by slug or ID.","exampleAgentPrompt":"Can you pull up the last 20 episodes of the All-In podcast published after January 1, 2024, and filter for any titles mentioning 'AI'?","exampleUseCases":[{"title":"Browse recent All-In episodes","prompt":"Show me the 10 most recent episodes of the All-In podcast published after March 1, 2024."},{"title":"Find episodes by title keyword","prompt":"List any episodes from the 'Lex Fridman Podcast' whose titles contain the word 'Ukraine' — use the slug 'lex-fridman-podcast'."},{"title":"Paginate through a podcast archive","prompt":"I need to go through all episodes of podcast ID 'hubermanlab' published before December 31, 2023 — fetch the first 50 and give me the pagination cursor so I can get the next batch."}],"resultDescription":"A paginated list of podcast episodes for the specified show, each with metadata such as title and publication date, along with an opaque cursor for fetching the next page of results.","failureModes":["Invalid or unknown podcast slug/ID returns a 404 or empty result set","Malformed ISO 8601 date strings in published_after or published_before cause a 400 error","Expired or invalid pagination cursor returns an error or unexpected results","Exceeding rate limits or insufficient USDC balance causes a 402 payment required error","Empty result set when no episodes match the title filter or date range"],"whenToPreferThis":"Use this endpoint when you need to enumerate or browse episodes of a known podcast by its slug or ID, optionally filtered by title keyword or publication date. Prefer this over a full-text search endpoint when you know the specific show and want a structured episode list rather than content-level search results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:56:06.796Z","isFirstParty":false}