Skip to main 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 and transcript 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.
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.

​
Example

A typical earnings call has two top-level sections, prepared remarks and a Q&A, each containing more specific segments at level 2.
Level 1
{
  "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.
Level 2
{
  "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.