List episodes

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/episodes?limit=25"

{
  "data": [
    {
      "duration_seconds": 123,
      "explicit": true,
      "has_transcript": true,
      "id": "<string>",
      "title": "<string>",
      "audio_url": "<string>",
      "clip_count": 123,
      "clips": [
        {
          "duration_seconds": 123,
          "end_seconds": 123,
          "engagement_score": 123,
          "id": "<string>",
          "start_seconds": 123,
          "title": "<string>",
          "audio_url": "<string>",
          "description": "<string>",
          "episode": {
            "id": "<string>",
            "title": "<string>",
            "podcast": {
              "id": "<string>",
              "title": "<string>",
              "image_url": "<string>",
              "publisher": {
                "id": "<string>",
                "name": "<string>",
                "slug": "<string>"
              },
              "slug": "<string>"
            },
            "published_at": "2023-11-07T05:31:56Z",
            "slug": "<string>"
          },
          "intro_statement": "<string>",
          "segment": {
            "id": "<string>",
            "title": "<string>",
            "type": "<string>"
          },
          "speaker": {
            "name": "<string>",
            "entity": {
              "id": "<string>",
              "name": "<string>",
              "slug": "<string>",
              "company": {
                "id": "<string>",
                "domain": "<string>",
                "ticker": "<string>"
              },
              "description": "<string>",
              "image_url": "<string>",
              "person": {
                "id": "<string>",
                "company": "<string>",
                "image_url": "<string>",
                "title": "<string>"
              },
              "type": {
                "name": "<string>",
                "slug": "<string>"
              },
              "wikipedia_url": "<string>"
            },
            "person": {
              "id": "<string>",
              "name": "<string>",
              "description": "<string>",
              "image_url": "<string>",
              "slug": "<string>"
            },
            "role": "<string>"
          }
        }
      ],
      "description": "<string>",
      "entity_count": 123,
      "episode_number": 123,
      "image_url": "<string>",
      "language": "<string>",
      "podcast": {
        "id": "<string>",
        "title": "<string>",
        "image_url": "<string>",
        "publisher": {
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>"
        },
        "slug": "<string>"
      },
      "published_at": "2023-11-07T05:31:56Z",
      "segment_count": 123,
      "segments": [
        {
          "duration_seconds": 123,
          "end_seconds": 123,
          "id": "<string>",
          "number": 123,
          "start_seconds": 123,
          "title": "<string>",
          "type": "<string>",
          "audio_url": "<string>",
          "description": "<string>",
          "episode": {
            "id": "<string>",
            "title": "<string>",
            "podcast": {
              "id": "<string>",
              "title": "<string>",
              "image_url": "<string>",
              "publisher": {
                "id": "<string>",
                "name": "<string>",
                "slug": "<string>"
              },
              "slug": "<string>"
            },
            "published_at": "2023-11-07T05:31:56Z",
            "slug": "<string>"
          },
          "read_type": "<string>",
          "summary": "<string>"
        }
      ],
      "slug": "<string>",
      "speakers": [
        {
          "name": "<string>",
          "description": "<string>",
          "descriptor": "<string>",
          "entity": {
            "id": "<string>",
            "name": "<string>",
            "slug": "<string>",
            "company": {
              "id": "<string>",
              "domain": "<string>",
              "ticker": "<string>"
            },
            "description": "<string>",
            "image_url": "<string>",
            "person": {
              "id": "<string>",
              "company": "<string>",
              "image_url": "<string>",
              "title": "<string>"
            },
            "type": {
              "name": "<string>",
              "slug": "<string>"
            },
            "wikipedia_url": "<string>"
          },
          "person": {
            "id": "<string>",
            "name": "<string>",
            "description": "<string>",
            "image_url": "<string>",
            "slug": "<string>"
          },
          "role": "<string>",
          "speaking_duration_seconds": 123
        }
      ],
      "topics": [
        {
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>",
          "ancestry": "<string>",
          "ancestry_path": "<string>",
          "episode_count": 123
        }
      ],
      "transcript": {
        "duration_seconds": 123,
        "episode_id": "<string>",
        "lines": [
          {
            "end_seconds": 123,
            "number": 123,
            "speaker": "<string>",
            "start_seconds": 123,
            "text": "<string>",
            "role": "<string>"
          }
        ],
        "language": "<string>"
      },
      "url": "<string>",
      "videos": [
        {
          "url": "<string>",
          "duration_seconds": 123,
          "height": 123,
          "mime_type": "<string>",
          "width": 123
        }
      ]
    }
  ],
  "has_more": true,
  "cursor": "<string>"
}

{
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "resolve": {
    "message": "<string>",
    "action": "<string>",
    "endpoint": "<string>",
    "method": "<string>",
    "url": "<string>"
  },
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

GET

podcasts

episodes

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/episodes?limit=25"

{
  "data": [
    {
      "duration_seconds": 123,
      "explicit": true,
      "has_transcript": true,
      "id": "<string>",
      "title": "<string>",
      "audio_url": "<string>",
      "clip_count": 123,
      "clips": [
        {
          "duration_seconds": 123,
          "end_seconds": 123,
          "engagement_score": 123,
          "id": "<string>",
          "start_seconds": 123,
          "title": "<string>",
          "audio_url": "<string>",
          "description": "<string>",
          "episode": {
            "id": "<string>",
            "title": "<string>",
            "podcast": {
              "id": "<string>",
              "title": "<string>",
              "image_url": "<string>",
              "publisher": {
                "id": "<string>",
                "name": "<string>",
                "slug": "<string>"
              },
              "slug": "<string>"
            },
            "published_at": "2023-11-07T05:31:56Z",
            "slug": "<string>"
          },
          "intro_statement": "<string>",
          "segment": {
            "id": "<string>",
            "title": "<string>",
            "type": "<string>"
          },
          "speaker": {
            "name": "<string>",
            "entity": {
              "id": "<string>",
              "name": "<string>",
              "slug": "<string>",
              "company": {
                "id": "<string>",
                "domain": "<string>",
                "ticker": "<string>"
              },
              "description": "<string>",
              "image_url": "<string>",
              "person": {
                "id": "<string>",
                "company": "<string>",
                "image_url": "<string>",
                "title": "<string>"
              },
              "type": {
                "name": "<string>",
                "slug": "<string>"
              },
              "wikipedia_url": "<string>"
            },
            "person": {
              "id": "<string>",
              "name": "<string>",
              "description": "<string>",
              "image_url": "<string>",
              "slug": "<string>"
            },
            "role": "<string>"
          }
        }
      ],
      "description": "<string>",
      "entity_count": 123,
      "episode_number": 123,
      "image_url": "<string>",
      "language": "<string>",
      "podcast": {
        "id": "<string>",
        "title": "<string>",
        "image_url": "<string>",
        "publisher": {
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>"
        },
        "slug": "<string>"
      },
      "published_at": "2023-11-07T05:31:56Z",
      "segment_count": 123,
      "segments": [
        {
          "duration_seconds": 123,
          "end_seconds": 123,
          "id": "<string>",
          "number": 123,
          "start_seconds": 123,
          "title": "<string>",
          "type": "<string>",
          "audio_url": "<string>",
          "description": "<string>",
          "episode": {
            "id": "<string>",
            "title": "<string>",
            "podcast": {
              "id": "<string>",
              "title": "<string>",
              "image_url": "<string>",
              "publisher": {
                "id": "<string>",
                "name": "<string>",
                "slug": "<string>"
              },
              "slug": "<string>"
            },
            "published_at": "2023-11-07T05:31:56Z",
            "slug": "<string>"
          },
          "read_type": "<string>",
          "summary": "<string>"
        }
      ],
      "slug": "<string>",
      "speakers": [
        {
          "name": "<string>",
          "description": "<string>",
          "descriptor": "<string>",
          "entity": {
            "id": "<string>",
            "name": "<string>",
            "slug": "<string>",
            "company": {
              "id": "<string>",
              "domain": "<string>",
              "ticker": "<string>"
            },
            "description": "<string>",
            "image_url": "<string>",
            "person": {
              "id": "<string>",
              "company": "<string>",
              "image_url": "<string>",
              "title": "<string>"
            },
            "type": {
              "name": "<string>",
              "slug": "<string>"
            },
            "wikipedia_url": "<string>"
          },
          "person": {
            "id": "<string>",
            "name": "<string>",
            "description": "<string>",
            "image_url": "<string>",
            "slug": "<string>"
          },
          "role": "<string>",
          "speaking_duration_seconds": 123
        }
      ],
      "topics": [
        {
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>",
          "ancestry": "<string>",
          "ancestry_path": "<string>",
          "episode_count": 123
        }
      ],
      "transcript": {
        "duration_seconds": 123,
        "episode_id": "<string>",
        "lines": [
          {
            "end_seconds": 123,
            "number": 123,
            "speaker": "<string>",
            "start_seconds": 123,
            "text": "<string>",
            "role": "<string>"
          }
        ],
        "language": "<string>"
      },
      "url": "<string>",
      "videos": [
        {
          "url": "<string>",
          "duration_seconds": 123,
          "height": 123,
          "mime_type": "<string>",
          "width": 123
        }
      ]
    }
  ],
  "has_more": true,
  "cursor": "<string>"
}

{
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "resolve": {
    "message": "<string>",
    "action": "<string>",
    "endpoint": "<string>",
    "method": "<string>",
    "url": "<string>"
  },
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Authorizations

X-API-Key

string

header

required

Pass your API key in the X-API-Key header (recommended).

Query Parameters

limit

integer<int64>

default:25

Results per page

Required range: 1 <= x <= 100

cursor

string

Opaque pagination cursor from previous response

podcast_id

string

Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID

entity_id

string

Entity slug (e.g., 'elon-musk', 'openai') or ID. Returns episodes featuring this entity as a speaker or mentioned entity.

person_id

string

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.

company_id

string

Company slug (e.g., 'nvidia'), domain (e.g., 'nvidia.com'), or ID. Resolves to the company's linked entity.

role

enum<string>

Entity role filter. Constrains which episodes match the entity_id, person_id, or company_id.

Available options:

guest,

host,

panelist,

correspondent,

mention

published_after

string

Only episodes published after this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)

published_before

string

Only episodes published before this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)

language

string

ISO 639-1 language code filter

has_transcript

boolean

Only episodes with completed transcripts

fully_ingested

boolean

Only episodes that have reached the terminal ingestion milestone (the highest stage exposed by the episode firehose)

min_duration

integer<int64>

Minimum episode duration in seconds

Required range: x >= 0

max_duration

integer<int64>

Maximum episode duration in seconds

Required range: x >= 0

Response

data

object[] | null

required

List of results

Show child attributes

has_more

boolean

required

Whether more results exist

cursor

string

Pass to next request for more results

Get segment transcript Poll the episode feed

⌘I

API documentation

Alerts

Companies

Embed

Entities

People

Podcasts

Podcast Advertising

Podcast Bias

Podcast Clips

Podcast Transcripts

Podcast Episodes

Podcast Episode Search

Podcast Segments

Podcast Guests

Podcast Publishers

Podcast Rankings

Podcast Brand Suitability

Podcast Ratings

Slack Connections

Webhook Connections

Topics

Authorizations

Query Parameters

Response