---
type: "firecrawl-provider"
description: "One episode, returned directly: its show, publication date, duration, speakers, topics, and optional web and audio links."
use_when: "Use episode.id from a search match to get the full record and, when available, its web URL or direct audio stream. Neither link is guaranteed. For what was said, fetch podcasts/transcript."
credits_per_call: 5
options: 1
---
# Particle: Podcast episode

One episode, returned directly: its show, publication date, duration, speakers, topics, and optional web and audio links.

## Agent instructions

Use episode.id from a search match to get the full record and, when available, its web URL or direct audio stream. Neither link is guaranteed. For what was said, fetch podcasts/transcript.

- Category file: [Podcasts category](https://alexandria.firecrawl.dev/agents/categories/podcasts)
- Provider file: [Provider guide](https://alexandria.firecrawl.dev/agents/providers/particle)
- Provider key: `particle`
- Capability: `podcasts/episode`
- Cost: 5 credits per call

## Request options

- `id` (string, required): Episode slug or id: episode.id on a search match, or id on an episode list row. A podcast slug is not an episode id. Example: `<id>`

## Request shape

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: <request> }` and your Firecrawl API key.

```json
{
  "provider": "particle",
  "capability": "podcasts/episode",
  "options": {
    "id": "<id>"
  }
}
```

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "particle",
    capability: "podcasts/episode",
    options: {
      id: "<id>",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "particle",
  "capability": "podcasts/episode",
  "options": {
    "id": "<id>"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "particle",
    "capability": "podcasts/episode",
    "options": {
      "id": "<id>"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'particle/podcasts/episode' \
  --options '{"id":"<id>"}'
```


## Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. These fields and the example below describe the provider payload in `data`.

```json
{
  "id": "<id>",
  "slug": "<slug>",
  "title": "<title>",
  "description": "<description>",
  "published_at": "<published_at>",
  "duration_seconds": 0,
  "explicit": false,
  "has_transcript": false,
  "language": "<language>",
  "episode_number": 0,
  "image_url": "<image_url>",
  "url": "<url>",
  "audio_url": "<audio_url>",
  "podcast": {},
  "speakers": [],
  "topics": [],
  "segments": [],
  "clips": [],
  "transcript": {},
  "videos": [],
  "clip_count": 0,
  "entity_count": 0,
  "segment_count": 0
}
```

## Explore other popular capabilities

If this capability is not the best match, fetch only the relevant capability file:

- [Episode search](https://alexandria.firecrawl.dev/agents/providers/particle/podcasts/episodes/search): Matching transcript segments with compact episode records under data. Beside data the body carries the resolved entity or company block when one was passed, and a diagnostics block when nothing matched. Read episode.id and fetch podcasts/episode for the optional episode web URL or audio stream; search does not return those links.
- [Show search](https://alexandria.firecrawl.dev/agents/providers/particle/podcasts/search): Matching shows, each with a match_quality from exact down to speculative, and the same filters podcasts/list takes.
- [Show directory](https://alexandria.firecrawl.dev/agents/providers/particle/podcasts/list): Shows matching the filters, most popular first when no query is given.
- [Show lookup by platform id](https://alexandria.firecrawl.dev/agents/providers/particle/podcasts/lookup): One result per identifier passed, echoing it beside the matched podcast. An unresolved identifier has no podcast field.
- [Episode transcript](https://alexandria.firecrawl.dev/agents/providers/particle/podcasts/transcript): In the dialogue format: the full transcript as ordered, numbered, speaker-labelled lines under lines, with episode_id, language and duration_seconds beside them. The text and srt formats answer with that format's body instead.