> ## Documentation Index
> Fetch the complete documentation index at: https://quartr.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Chapters

> Structured segments for navigating audio and transcript content

## Overview

Chapters divide audio recordings and transcripts into meaningful sections, making it easier to navigate, index, and reference specific parts of an event. Both the [audio](/api-reference/backlog-audio/list-audio-chapters) and [transcript](/api-reference/transcripts/list-transcript-chapters) endpoints expose chapters through dedicated sub-endpoints.

Each chapter includes a title, start timestamp, and end timestamp defining a distinct section within the content.

## Levels and nesting

The `level` field defines the hierarchical depth of a chapter.

* **Level 1**: Top-level sections (e.g., "Prepared Remarks", "Q\&A").
* **Level 2**: Subsections nested within a level 1 chapter (e.g., individual topics within "Prepared Remarks").
* **Level 3+**: Further nesting is possible for finer granularity.

Chapters are always contained within the timestamp range of their parent. All level 2 chapters fall within the start and end timestamps of their level 1 parent. Clients must be prepared to handle arbitrary depth.

<Info>
  Only level 1 chapters are returned by default. To retrieve deeper levels, use the `levels` query parameter. Multiple levels can be requested at once, e.g. `levels=1,2`.
</Info>

## Example

A typical earnings call has two top-level sections, prepared remarks and a Q\&A, each containing more specific segments at level 2.

```json Level 1 theme={null}
{
  "data": [
    {
      "id": 1001,
      "title": "Prepared Remarks",
      "startTimestamp": 0,
      "endTimestamp": 1542,
      "level": 1
    },
    {
      "id": 1002,
      "title": "Q&A",
      "startTimestamp": 1542,
      "endTimestamp": 3120,
      "level": 1
    }
  ]
}
```

Querying with `levels=2` for the same audio returns the subsections within each top-level chapter.

```json Level 2 theme={null}
{
  "data": [
    {
      "id": 2001,
      "title": "CEO Opening Remarks",
      "startTimestamp": 0,
      "endTimestamp": 620,
      "level": 2
    },
    {
      "id": 2002,
      "title": "CFO Financial Review",
      "startTimestamp": 620,
      "endTimestamp": 1542,
      "level": 2
    },
    {
      "id": 2003,
      "title": "Analyst Questions",
      "startTimestamp": 1542,
      "endTimestamp": 3120,
      "level": 2
    }
  ]
}
```

### Interpreting timestamps

The `startTimestamp` and `endTimestamp` fields are in **seconds** from the beginning of the recording.

Notice how the level 2 chapters nest within the timestamp ranges of their level 1 parents. "CEO Opening Remarks" and "CFO Financial Review" both fall within the "Prepared Remarks" window (0–1542s), while "Analyst Questions" falls within "Q\&A" (1542–3120s). You can use this relationship to build a tree structure for navigation.

## How to access this data

<CardGroup cols={2}>
  <Card title="REST API" icon="code" href="/api-reference/backlog-audio/list-audio-chapters">
    Retrieve chapters for a given audio or transcript record.
  </Card>

  <Card title="Snowflake" icon="snowflake" href="/snowflake/getting-started">
    Query the chapters view directly using SQL.
  </Card>
</CardGroup>