Podcast Segments
tier:standard

List segments

Returns AI-identified segments across podcast episodes. Segments represent structural sections like topic discussions, interviews, ads, etc. At least one of episode_id, podcast_id, or type is required — this endpoint does not return a global feed.

get/v1/podcasts/segments

Request

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

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

episode_idstring

Filter to a specific episode by slug or ID. At least one of episode_id, podcast_id, or type is required.

podcast_idstring

Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID. At least one of episode_id, podcast_id, or type is required.

type'INTRO' | 'PERSONAL_BANTER' | 'TOPIC_DISCUSSION' | 'INTERVIEW' | 'TRANSITION' | 'AD' | 'OUTRO'

Segment type filter, case-insensitive: INTRO, PERSONAL_BANTER, TOPIC_DISCUSSION, INTERVIEW, TRANSITION, AD, OUTRO. At least one of episode_id, podcast_id, or type is required.

sincestring

Only include segments from episodes published on or after this ISO 8601 date or date-time

Example:2025-01-01T00:00:00Z
untilstring

Only include segments from episodes published before this ISO 8601 date or date-time

Example:2026-01-01T00:00:00Z

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

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