Endpoints

Transcript

Retrieve the transcript for a single earnings call.

GEThttps://alpha.earningscall.dev/transcript

Returns the transcript for one earnings call. The level parameter selects the shape of the response: a single text blob (level 1), speaker-segmented turns (level 2), word-level timestamps (level 3), or the call split into prepared remarks and Q&A (level 4).

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

Parameters#

apikeystringRequired
Your API key.
exchangestringRequired
Stock exchange, e.g. NASDAQ.
symbolstringRequired
Ticker symbol.
yearintegerRequired
4-digit year of the earnings call.
quarterintegerRequired
Fiscal quarter, 1–4. Accepts q1 or Q1 formats too.
levelintegerOptional
Detail 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://alpha.earningscall.dev/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. Each turn carries its own speaker object with the speaker's id, name and title. Requires an Enhanced Transcript plan.

curl 'https://alpha.earningscall.dev/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"
  },
  "speakers": [
    {
      "speaker": {
        "id": "spk12",
        "name": "Teja Skala",
        "title": "Director of Investor Relations and Corporate Finance"
      },
      "text": "Good day, everyone, and welcome to the Apple Q1 Fiscal Year 2023 Earnings Conference Call..."
    },
    {
      "speaker": {
        "id": "spk01",
        "name": "Tim Cook",
        "title": "CEO"
      },
      "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://alpha.earningscall.dev/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": {
        "id": "spk12",
        "name": "Teja Skala",
        "title": "Director of Investor Relations and Corporate Finance"
      },
      "words": [
        "Good",
        "day,",
        "everyone,",
        "and",
        "welcome",
        "to"
      ],
      "start_times": [
        0.009,
        0.129,
        0.269,
        0.709,
        0.87,
        1.19
      ]
    }
  ]
}

Level 4 — prepared remarks and Q&A#

Splits the call into its two halves: management's prepared remarks and the analyst question-and-answer session. Both are plain text. Requires an Enhanced Transcript plan.

curl 'https://alpha.earningscall.dev/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"
  },
  "prepared_remarks": "Good day, everyone, and welcome to the Apple Q1 Fiscal Year 2023 Earnings Conference Call. Today's call is being recorded...",
  "questions_and_answers": "We will go ahead and take our first question from David Bott with UBS. Great. Thanks, guys, for taking my question..."
}

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.