{"slug":"api-particle-pro-v1-podcasts-episodes-b0eff4","title":"List episodes","host":"api.particle.pro","method":"GET","resource":"https://api.particle.pro/v1/podcasts/episodes","category":"other","description":"List episodes. Returns a paginated list of podcast episodes across all podcasts.","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":201,"reported_calls_30d":5,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"language":"fr"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"properties":{"company_id":{"description":"Company slug (e.g., 'nvidia'), domain (e.g., 'nvidia.com'), or ID. Resolves to the company's linked entity.","type":"string"},"cursor":{"description":"Opaque pagination cursor from previous response","type":"string"},"entity_id":{"description":"Entity slug (e.g., 'elon-musk', 'openai') or ID. Returns episodes featuring this entity as a speaker or mentioned entity.","type":"string"},"fully_ingested":{"description":"Only episodes that have reached the terminal ingestion milestone (the highest stage exposed by the episode firehose)","type":"boolean"},"has_transcript":{"description":"Only episodes with completed transcripts","type":"boolean"},"language":{"description":"Restrict to episodes of podcasts in this language (ISO 639-1 code, e.g. 'fr'). Matches the podcast's primary language subtag, so 'fr' covers 'fr-FR'.","type":"string"},"limit":{"description":"Results per page","format":"int64","type":"integer"},"max_duration":{"description":"Maximum episode duration in seconds","format":"int64","type":"integer"},"min_duration":{"description":"Minimum episode duration in seconds","format":"int64","type":"integer"},"person_id":{"description":"Person slug (e.g., 'dick-costolo'), knowledge-graph entity slug for the same person, or ID. Returns episodes featuring this person as a speaker — works even when the speaker has no knowledge-graph entity linked. When the value itself matches a knowledge-graph entity slug (corroborated to the same person), the default and 'mention' roles also include episodes that merely mention the person, matching entity_id semantics; pass a speaker role (guest, host, panelist, correspondent) for speaker-only results.","type":"string"},"podcast_id":{"description":"Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID","type":"string"},"published_after":{"description":"Only episodes published after this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)","type":"string"},"published_before":{"description":"Only episodes published before this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)","type":"string"},"role":{"description":"Entity role filter. Constrains which episodes match the entity_id, person_id, or company_id. 'speaker' matches any speaking role (host, co-host, guest, panelist, correspondent) without including mention-only episodes.","enum":["guest","host","panelist","correspondent","speaker","mention"],"type":"string"}},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":201,"error":null}],"description_full":"List episodes. Returns a paginated list of podcast episodes across all podcasts.","last_updated":"2026-09-09T10:12:12.978Z","schemes":["exact"]}