{"uid":"cap_NWMMDYI55uj401UX8YZxk","slug":"particle-pro-podcast-episode-timeseries-338dc04c","name":"Particle Pro – Podcast Episode Timeseries","description":"Get episode timeseries. Returns time-bucketed counts of episodes matching the same filters as GET /v1/podcasts/episodes, plus range totals.","url":"https://api.particle.pro/v1/podcasts/episodes/timeseries?utm_source=zero.xyz","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","properties":{"role":{"enum":["guest","host","panelist","correspondent","speaker","mention"],"type":"string","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."},"since":{"type":"string","description":"Inclusive start of the range as an ISO 8601 date or date-time. Omit for all time."},"until":{"type":"string","description":"End of the range as an ISO 8601 date or date-time. A bare date includes that whole day. Defaults to now."},"interval":{"enum":["day","week","month"],"type":"string","description":"Bucket width. Weeks start on Monday and all buckets are UTC-aligned."},"language":{"type":"string","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'."},"entity_id":{"type":"string","description":"Entity or person slug (e.g., 'elon-musk', 'openai') or ID. Counts episodes featuring this entity as a speaker or mentioned entity. A person with no linked entity counts the episodes they speak in. A slug that names both an entity and a person means the entity; pass the person's ID to count the person."},"person_id":{"type":"string","description":"Person slug (e.g., 'dick-costolo'), knowledge-graph entity slug for the same person, or ID. Counts 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 count episodes that merely mention the person, matching entity_id semantics; pass a speaker role (guest, host, panelist, correspondent) for speaker-only counts."},"company_id":{"type":"string","description":"Company slug (e.g., 'nvidia'), domain (e.g., 'nvidia.com'), or ID. Resolves to the company's linked entity."},"podcast_id":{"type":"string","description":"Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID"},"guest_field":{"type":"string","description":"Only episodes with a guest listed under this ANZSRC 2020 field of research (code, slug, or title)."},"max_duration":{"type":"integer","format":"int64","description":"Maximum episode duration in seconds"},"min_duration":{"type":"integer","format":"int64","description":"Minimum episode duration in seconds"},"fully_ingested":{"type":"boolean","description":"Only count episodes that have reached the terminal ingestion milestone"},"guest_capacity":{"enum":["researcher","licensed_professional","practitioner","executive_founder","public_official","journalist_analyst","creator_entertainer","athlete_coach","clergy","firsthand","layperson"],"type":"string","description":"Only episodes with a guest who knows their field in this capacity, such as executive_founder for founders. It narrows the other filters; an everyday word for a capacity passed as guest_occupation (founders, politicians) lands here too."},"guest_in_field":{"type":"boolean","description":"Only episodes with a guest speaking within their field (the guest the other guest_ filters select, when given)."},"guest_standing":{"enum":["established","self_described","unverified"],"type":"string","description":"Only episodes with a guest whose standing is recognized this way."},"has_transcript":{"type":"boolean","description":"Only count episodes with completed transcripts"},"keyword_search":{"type":"string","description":"Keyword filter over episode transcript content. Double-quoted substrings must appear as exact phrases; unquoted terms must all appear in a transcript segment. Counts episodes with at least one matching segment and adds mention_count fields to the response. Combines with the other filters, but not with semantic_search."},"guest_seniority":{"enum":["professional","senior","distinguished"],"type":"string","description":"Only episodes with a guest at this seniority or above."},"published_after":{"type":"string","description":"Deprecated alias of since."},"semantic_search":{"type":"string","description":"Vector-similarity filter by meaning over episode transcript content — the counting twin of the search endpoint's semantic_search, using the same similarity threshold. Express the query the way you'd describe the topic to a colleague; paraphrase tolerant. Counts episodes with at least one semantically matching segment and adds mention_count fields to the response; for pathologically broad queries the mention counts can be lower bounds. Requires since (ranges up to ~2 years). Combines with the other filters, but not with keyword_search."},"guest_occupation":{"type":"string","description":"Only episodes with a guest listed under this SOC 2018 or ISCO-08 occupation (code, slug, or title), including a SOC group or everyday name such as physicians or doctors. A word with no occupation filters by the field of research or capacity it names: oncologists is field 3211, founders is guest_capacity=executive_founder."},"guest_practicing":{"type":"boolean","description":"Only episodes with a guest who still works in guest_occupation, a SOC 2018 occupation or group."},"published_before":{"type":"string","description":"Deprecated alias of until."}}}},"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_mKf2rzCZTx_s1a2SRDdWk","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":"Returns time-bucketed counts of podcast episodes matching entity, person, company, language, and date filters, plus range totals.","exampleAgentPrompt":"Show me the monthly count of podcast episodes featuring Elon Musk as a guest from January 2023 through December 2023, bucketed by month.","exampleUseCases":[{"title":"Tracking company podcast mention trends","prompt":"How many podcast episodes per month mentioned OpenAI between January 2022 and June 2024? Break it down month by month so I can see the trend over time."},{"title":"Monitoring a person's media presence growth","prompt":"Can you chart Sam Altman's weekly podcast appearances as a speaker for the past year? I want to see if his media presence has been growing."},{"title":"Competitive media analysis by quarter","prompt":"Get me the monthly episode counts for Apple, Google, and Microsoft podcast appearances over the last two years — I'm trying to compare how much podcast coverage each company gets."}],"resultDescription":"A timeseries array of objects, each representing a time bucket (day, week, or month) with an episode count matching the specified filters, plus aggregate range totals for the full query window.","failureModes":["Invalid entity_id or person_id slug returns empty results or 404","Unsupported interval value returns a 400 validation error","Malformed ISO 8601 date strings in since/until return a 400 error","Invalid language code returns no results or a 400 error","Payment not included or insufficient returns a 402 error","Role filter incompatible with provided entity type may return empty results"],"whenToPreferThis":"Use this endpoint when you need trend analysis or time-series aggregation of podcast episode counts for a specific entity, person, or company — rather than listing individual episodes. Choose this over the standard episodes list endpoint when the goal is charting, visualization, or measuring media velocity over time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T00:36:40.724Z","isFirstParty":false,"canonicalSlug":"particle-pro-podcast-episode-timeseries-338dc04c"}