---
type: "firecrawl-provider"
description: "In the dialogue format: the segment's lines, renumbered from 1 with timestamps relative to the segment's start. The text and srt formats answer with that format's body instead."
use_when: "Use to read the words of one segment in full and in order, at the price of a segment rather than an episode."
credits_per_call: 15
options: 2
---
# Particle: Segment transcript

In the dialogue format: the segment's lines, renumbered from 1 with timestamps relative to the segment's start. The text and srt formats answer with that format's body instead.

## Agent instructions

Use to read the words of one segment in full and in order, at the price of a segment rather than an episode.

- 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/segment/transcript`
- Cost: 15 credits per call

## Request options

- `id` (string, required): Segment id. Example: `<id>`
- `format` (string): Output format: dialogue (speaker-attributed JSON lines, the shape described here), text (Speaker: text lines), or srt (SubRip). The text and srt bodies are not the lines shape. Example: `dialogue`

## Request shape

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

```json
{
  "provider": "particle",
  "capability": "podcasts/segment/transcript",
  "options": {
    "id": "<id>",
    "format": "dialogue"
  }
}
```

### JavaScript

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

### Python

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

### 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/segment/transcript",
    "options": {
      "id": "<id>",
      "format": "dialogue"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'particle/podcasts/segment/transcript' \
  --options '{"id":"<id>","format":"dialogue"}'
```


## Response data

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

```json
{
  "lines": [
    {
      "number": 0,
      "speaker": "<speaker>",
      "role": "<role>",
      "text": "<text>",
      "start_seconds": 0,
      "end_seconds": 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.
- [Podcast episode](https://alexandria.firecrawl.dev/agents/providers/particle/podcasts/episode): One episode, returned directly: its show, publication date, duration, speakers, topics, and optional web and audio links.