Podcast Episodes
tier:standard

Stream episodes (POST)

Identical to the GET form (Enterprise plan only), but accepts the podcast filter in a JSON body so you can pass a large podcast_ids set (up to 1000) without hitting query-string limits. The milestone, cursor, and since controls remain query parameters.

post/v1/podcasts/episodes/stream

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/episodes/stream
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

milestone'discovered' | 'transcribed' | 'segmented' | 'fully_ingested'

Hydration milestone to stream. Episodes are delivered once they reach this stage. Milestones are ordered discovered < transcribed < segmented < fully_ingested.

cursorstring

Opaque cursor from a prior event envelope. When supplied, the stream replays everything after it then continues live.

sincestring

ISO 8601 date or date-time to backfill from when no cursor is supplied. Ignored if cursor is set.

includestring[] nullable

Heavy relations to embed in each episode (comma-separated). transcript is the dialogue transcript; segments and clips are the AI-derived sets; entities are the knowledge graph entities discussed, with the transcript lines that mention each; ads are the advertising spots detected; all means everything available at the chosen milestone. A field is only valid when its data is guaranteed at the milestone (transcript→transcribed, segments→segmented, clips, entities and ads→fully_ingested); requesting one earlier is a terminal error.

Request body

podcast_idsstring[] nullable

Filter to a set of podcasts by slug or ID. An episode is delivered if its podcast matches any of them. Unknown values are ignored; if none match you receive a terminal error rather than the full firehose.

popularity_thresholdnumber double

Filter to podcasts whose popularity percentile is at least this value, in (0,1). Omit (or 0) for no popularity filter. Popularity is normalized 0–1 across the catalog, so 0.9 ≈ the top 10%. Combines with podcast_ids as a union.

Response

OK

Changes

No recorded changes to this operation across all 2 revisions of this API.