Endpoints

Transcript

Retrieve the transcript for a single earnings call.

GEThttps://v2.api.alpha.earningscall.biz/transcript

Returns the transcript for one earnings call. The level parameter controls how much detail is included — from a single text blob (level 1) up to word-level timestamps (level 3) and speaker-segmented turns (level 4).

Levels 2 through 4 require a plan that includes advanced transcripts. Level 1 is available to every paid plan.

Parameters#

ParameterTypeDescription
apikeystringRequiredYour API key.
exchangestringRequiredStock exchange, e.g. NASDAQ.
symbolstringRequiredTicker symbol.
yearintegerRequired4-digit year of the earnings call.
quarterintegerRequiredFiscal quarter, 1–4. Accepts q1 or Q1 formats too.
levelintegerOptionalDetail level, 1 (default) through 4. Levels 2+ require an Enhanced Transcript plan.

Examples#

Level 1 — full transcript text#

The default level. Returns the entire transcript as a single string. Available to every plan.

curl 'https://v2.api.alpha.earningscall.biz/transcript?apikey=demo&exchange=NASDAQ&symbol=AAPL&year=2023&quarter=1'

Response

{
  "event": {
    "year": 2023,
    "quarter": 1,
    "conference_date": "2023-02-02T17:00:00.000-05:00"
  },
  "text": "Good day, everyone, and welcome to the Apple Q1 Fiscal Year 2023 Earnings Conference Call. Today's call is being recorded...."
}

Level 2 — speaker diarization#

Segments the transcript into distinct speaker turns and maps speaker IDs to names and titles. Requires an Enhanced Transcript plan.

curl 'https://v2.api.alpha.earningscall.biz/transcript?apikey=demo&exchange=NASDAQ&symbol=AAPL&year=2023&quarter=1&level=2'

Response

{
  "event": {
    "year": 2023,
    "quarter": 1,
    "conference_date": "2023-02-02T17:00:00.000-05:00"
  },
  "speaker_name_map_v2": {
    "spk12": {
      "name": "Operator",
      "title": "Conference Call Host"
    },
    "spk07": {
      "name": "Teja Skala",
      "title": "Director of Investor Relations"
    },
    "spk01": {
      "name": "Tim Cook",
      "title": "CEO"
    }
  },
  "speakers": [
    {
      "speaker": "spk12",
      "text": "Good day, everyone, and welcome to the Apple Q1 Fiscal Year 2023 Earnings Conference Call..."
    },
    {
      "speaker": "spk01",
      "text": "Thank you, Tejas. Good afternoon, everyone, and thanks for joining us. Today we're reporting revenue of $117.2 billion..."
    }
  ]
}

Level 3 — word-level timestamps#

Adds word-level start/end timestamps, useful for transcript-aligned playback. Requires an Enhanced Transcript plan.

curl 'https://v2.api.alpha.earningscall.biz/transcript?apikey=demo&exchange=NASDAQ&symbol=AAPL&year=2023&quarter=1&level=3'

Response

{
  "event": {
    "year": 2023,
    "quarter": 1,
    "conference_date": "2023-02-02T17:00:00.000-05:00"
  },
  "speakers": [
    {
      "speaker": "spk01",
      "words": [
        {
          "word": "Thank",
          "start": 12.1,
          "end": 12.3
        },
        {
          "word": "you,",
          "start": 12.31,
          "end": 12.55
        },
        {
          "word": "Tejas.",
          "start": 12.56,
          "end": 13.01
        }
      ]
    }
  ]
}

Level 4 — speaker groups#

Combines speaker name mapping with grouped turns, ideal for rendering a clean transcript UI. Requires an Enhanced Transcript plan.

curl 'https://v2.api.alpha.earningscall.biz/transcript?apikey=demo&exchange=NASDAQ&symbol=AAPL&year=2023&quarter=1&level=4'

Response

{
  "event": {
    "year": 2023,
    "quarter": 1,
    "conference_date": "2023-02-02T17:00:00.000-05:00"
  },
  "speaker_groups": [
    {
      "speaker_info": {
        "name": "Tim Cook",
        "title": "CEO"
      },
      "text": "Thank you, Tejas. Good afternoon, everyone, and thanks for joining us..."
    }
  ]
}

Error responses#

See the Errors page for the full error format. This endpoint can return:

400missing_parameter — Missing exchange, symbol, year, or quarter.400invalid_parameter — Non-integer or out-of-range value.401invalid_api_key — Auth failure.403demo_restriction — Demo account requesting a ticker other than AAPL or MSFT on NASDAQ.403plan_restriction — Plan does not include the requested transcript level.404resource_not_found — Transcript not available for the requested call.429rate_limit_exceeded — Plan rate limit exceeded.

Plan access#

Level 1 transcripts are available on every paid plan. Levels 2, 3, and 4 require Premium, Ultimate, Ultimate Plus, Seed, Enterprise, or Enterprise Plus.