Skip to main content

​
Segments

Every episode is broken into semantic segments by AI. A segment is a contiguous section of the episode with a specific purpose — a topic discussion, an interview, an ad read, or the intro.

​
Segment types

TypeDescription
TOPIC_DISCUSSIONIn-depth discussion of a specific subject
INTERVIEWQuestion-and-answer with a guest
INTROOpening of the episode
OUTROClosing of the episode
PERSONAL_BANTEROff-topic or personal conversation
TRANSITIONBridge between segments
ADAdvertisement or sponsorship read

​
Segments for an episode

Returns segments in chronological order — this is the structural outline of the episode: 
curl "https://api.particle.pro/v1/podcasts/episodes/6OdMXSZK8XxM89hbS3eanr/segments" \
  -H "X-API-Key: YOUR_API_KEY"
Example response
{
  "data": [
    {
      "id": "9fLwNa2mK7Rp4xYb",
      "number": 1,
      "type": "INTRO",
      "title": "Welcome and show overview",
      "description": "Kevin and Casey introduce the episode and preview today's topics.",
      "summary": "The hosts welcome listeners and outline three stories...",
      "start_seconds": 0.0,
      "end_seconds": 185.4,
      "duration_seconds": 185.4,
      "audio_url": "https://audio.particle.pro/seg/9fLwNa2mK7Rp4xYb.mp3",
      "episode": {
        "id": "6OdMXSZK8XxM89hbS3eanr",
        "title": "The Future of AI Regulation",
        "podcast": {
          "id": "2dMXSZK8XxM89hbS3eanr",
          "title": "Hard Fork"
        }
      }
    },
    {
      "id": "Kp3mRvWn8dYx2LbQ",
      "number": 2,
      "type": "TOPIC_DISCUSSION",
      "title": "EU AI Act implementation timeline",
      "start_seconds": 185.4,
      "end_seconds": 1247.8,
      "duration_seconds": 1062.4,
      "audio_url": "https://audio.particle.pro/seg/Kp3mRvWn8dYx2LbQ.mp3"
    }
  ],
  "has_more": false
}
Each segment has its own audio file and transcript endpoint.

​
Cross-episode segment discovery

Find segments across all podcasts, filtered by type: 
# All interview segments from the last week
curl "https://api.particle.pro/v1/podcasts/segments?\
type=INTERVIEW&\
limit=10" \
  -H "X-API-Key: YOUR_API_KEY"
Filter further by podcast_id or episode_id.

​
Clips

Clips are the highlight moments — the parts of an episode most worth sharing. AI identifies them from within segments and scores each one for .

​
Clip types

Takes & opinions

TypeWhat it captures
SPICYA bold or provocative take
CONTROVERSIALA divisive or debatable opinion
DEBATE_DISAGREEMENTA point of contention between speakers
TypeWhat it captures
FUNNYA genuinely funny moment
EMOTIONALAn emotionally resonant moment
SHOCKINGA surprising revelation
TypeWhat it captures
INSIGHTFULA non-obvious insight or analysis
INFORMATIVEA clear explanation of something complex
EDUCATIONALTeaching a concept or skill
PHILOSOPHICALA deep or abstract reflection
AHA_MOMENTA realization or breakthrough in the conversation
TypeWhat it captures
NOTABLE_LINEA memorable quote or one-liner
BEST_STORYA compelling narrative or anecdote

​
Clips for an episode

Returns clips ranked by engagement score (highest first): 
curl "https://api.particle.pro/v1/podcasts/episodes/6OdMXSZK8XxM89hbS3eanr/clips" \
  -H "X-API-Key: YOUR_API_KEY"

​
Clip response schema

​
id
string
required
Unique clip identifier.
​
type
string
required
One of the clip types listed above.
​
title
string
required
AI-generated clip title.
​
description
string
AI-generated description of what happens in the clip.
​
intro_statement
string
A ready-to-use hook for social media posts or show notes.
​
engagement_score
number
required
0.0 to 1.0. Higher means the AI predicts this clip will resonate more.
​
speaker
object
The primary speaker in this clip.
​
segment
object
The structural context — which segment this clip comes from.
​
start_seconds
number
required
Start time within the episode.
​
end_seconds
number
required
End time within the episode.
​
duration_seconds
number
required
Clip duration.
​
audio_url
string
Direct MP3 URL for this clip.
Example response
{
  "data": [
    {
      "id": "3hR8jUVn5cQwDzXe",
      "type": "INSIGHTFUL",
      "title": "Why open-source AI will win the regulation battle",
      "description": "Casey argues that open-source models will be effectively unregulatable...",
      "intro_statement": "In a striking prediction, Casey Newton explains why he thinks AI regulation is fundamentally incompatible with open-source development.",
      "engagement_score": 0.94,
      "start_seconds": 892.3,
      "end_seconds": 958.7,
      "duration_seconds": 66.4,
      "audio_url": "https://audio.particle.pro/clip/3hR8jUVn5cQwDzXe.mp3",
      "speaker": {
        "name": "Casey Newton",
        "role": "CO_HOST",
        "entity_id": "Lm0wY3F0OTA"
      },
      "segment": {
        "id": "Kp3mRvWn8dYx2LbQ",
        "type": "TOPIC_DISCUSSION",
        "title": "EU AI Act implementation timeline"
      },
      "episode": {
        "id": "6OdMXSZK8XxM89hbS3eanr",
        "title": "The Future of AI Regulation",
        "published_at": "2026-02-18T14:00:00Z",
        "podcast": {
          "id": "2dMXSZK8XxM89hbS3eanr",
          "title": "Hard Fork",
          "image_url": "https://images.particle.pro/2dMXSZK8XxM89hbS3eanr.jpg"
        }
      }
    }
  ],
  "has_more": false
}

​
Cross-episode clip discovery

Find the best clips across all podcasts: 
# Funniest clips with high engagement from a specific podcast
curl "https://api.particle.pro/v1/podcasts/clips?\
type=FUNNY&\
min_engagement=0.8&\
podcast_id=2dMXSZK8XxM89hbS3eanr&\
limit=10" \
  -H "X-API-Key: YOUR_API_KEY"
Sort options: engagement (default), published_at, duration.

​
Audio

Every segment and clip has a direct audio_url pointing to an extracted MP3 file. No need to download the full episode and slice it yourself.