EarningsCall API Documentation

Mastering financial insights with the EarningsCall API

You can use our Application Programming Interface (API) to programmatically access earnings call data. Through this API, you can list an individual company's earnings call dates, retrieve the transcript text, and download the raw audio files.

SDKs

Software Development Kits (SDKs) are available for the following languages:

We have plans to add support for the following languages:

  • TypeScript
  • JavaScript/Node.js

Get Earnings Events

URL Endpoint :https://v2.api.earningscall.biz/events
HTTP Verb :GET
Parameter :"apikey" - We will give you a unique API Key to use. Please do not share this key with anyone. Use “demo” to try it out.
Parameter :"exchange" - Valid values: "NYSE", "NASDAQ", "AMEX", "TSX", "TSXV" or "OTC".
Parameter :"symbol" - The ticker symbol.
Result :JSON Object

HTTP Response Status Codes

200Success
401Missing or invalid API Key
403Not authorized to call this API
404Not found

Example Usage

curl 'https://v2.api.earningscall.biz/events?apikey=demo&exchange=nasdaq&symbol=aapl'

Example Output

{
  "company_name": "Apple Inc.",
  "events": [
    {
      "year": 2024,
      "quarter": 2,
      "conference_date": "2024-05-02T17:00:00.000-04:00"
    },
    {
      "year": 2024,
      "quarter": 1,
      "conference_date": "2024-02-01T17:00:00.000-05:00"
    },
    {
      "year": 2023,
      "quarter": 4,
      "conference_date": "2023-11-03T17:00:00.000-04:00"
    },
    {
      "year": 2023,
      "quarter": 3,
      "conference_date": "2023-08-03T17:00:00.000-04:00"
    },
    {
      "year": 2023,
      "quarter": 2,
      "conference_date": "2023-05-04T14:00:00.000-07:00"
    },
    {
      "year": 2023,
      "quarter": 1,
      "conference_date": "2023-02-02T17:00:00.000-05:00"
    },
    {
      "year": 2022,
      "quarter": 4,
      "conference_date": "2022-10-27T14:00:00.000-07:00"
    },
    {
      "year": 2022,
      "quarter": 3,
      "conference_date": "2022-07-28T17:00:00.000-04:00"
    },
    {
      "year": 2022,
      "quarter": 2,
      "conference_date": "2022-04-28T14:00:00.000-07:00"
    },
    {
      "year": 2022,
      "quarter": 1,
      "conference_date": "2022-01-27T14:00:00.000-08:00"
    },
    {
      "year": 2021,
      "quarter": 4,
      "conference_date": "2021-10-28T16:00:00.000-04:00"
    },
    {
      "year": 2021,
      "quarter": 3,
      "conference_date": "2021-07-27T16:00:00.000-04:00"
    },
    {
      "year": 2021,
      "quarter": 2,
      "conference_date": "2021-04-28T16:00:00.000-04:00"
    },
    {
      "year": 2021,
      "quarter": 1,
      "conference_date": "2021-01-27T14:00:00.000-08:00"
    },
    {
      "year": 2020,
      "quarter": 4,
      "conference_date": "2020-10-29T14:00:00.000-07:00"
    },
    {
      "year": 2020,
      "quarter": 3,
      "conference_date": "2020-07-30T14:00:00.000-04:00"
    },
    {
      "year": 2020,
      "quarter": 2,
      "conference_date": "2020-04-30T14:00:00.000-07:00"
    }
  ]
}

Get Earnings Call Transcript

URL Endpoint :https://v2.api.earningscall.biz/transcript
HTTP Verb :GET
Parameter :"apikey" - We will give you a unique API Key to use. Please do not share this key with anyone. Use “demo” to try it out.
Parameter :"exchange" - Valid values: "NYSE", "NASDAQ", "AMEX", "TSX", "TSXV" or "OTC".
Parameter :"symbol" - The ticker symbol.
Parameter :"year" - The 4 digit year of the earnings call. Example value: "2024".
Parameter :"quarter" - Valid values: 1, 2, 3, or 4.
Optional Parameter :"level" - Default Value: 1. Valid values: 1, 2, 3, or 4. Basic Transcript Plan includes level 1 (which is default). Enhanced Transcript Plan includes levels 2 and 3. Used to retrieve enhanced transcript data.
Result :JSON Object

HTTP Response Status Codes

200Success
401Missing or invalid API Key
403Not authorized to call this API
404Not found

Example 1: Get Basic Transcript Text

Level 1 (default) is the most basic version of transcript data. It is the entire transcript text in one long string.

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

Example 1: Output

{
  "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...."
}

Example 2: Get Level 2 Enhanced Transcript Data

Level 2 Transcript data contains speaker diarizations. It is included in any plan that contains enhanced transcript data.

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

Example 2: Output

{
  "event": {
    "year": 2023,
    "quarter": 1,
    "conference_date": "2023-02-02T17:00:00.000-05:00"
  },
  "speakers": [
    {
      "speaker": "spk12",
      "text": "Good day, everyone, and welcome to the Apple Q1 Fiscal Year 2023 Earnings Conference Call. Today's call is being recorded. And now at this time, for opening remarks and introductions, I would like to turn the call over to Teja Skala, Director of Investor Relations and Corporate Finance. Please go ahead."
    },
    {
      "speaker": "spk07",
      "text": "Thank you. Speaking first today is Apple CEO Tim Cook, and he'll be followed by CFO Luca Maestri. After that, we'll open the call to questions from analysts. Before turning the call over to Tim, I would like to remind everyone that the December quarter spanned 14 weeks, while the March quarter, as usual, has 13 weeks. Please note that some of the information you'll hear during our discussion today will consist of forward-looking statements including, without limitation, those regarding revenue, gross margin, operating expenses, other income and expense, taxes, capital allocation, and the future business outlook, including the potential impact of COVID-19 on the company's business and results of operations. These statements involve risks and uncertainties that may cause actual results or trends to differ materially from our forecast. For more information, please refer to the risk factors discussed in Apple's most recently filed annual report on Form 10-K and the Form 8-K filed with the SEC today, along with the associated press release. Apple assumes no obligation to update any forward-looking statements or information which speak as of their respective dates. I'd now like to turn the call over to Tim for introductory remarks."
    },
    {
      "speaker": "spk01",
      "text": "Thank you, Tejas. Good afternoon, everyone, and thanks for joining us. Today we're reporting revenue of $117.2 billion for the December quarter...."
    },
    {
      "speaker": "spk07",
      "text": "Thanks, Krish. A replay of today's call will be available for two weeks on Apple Podcasts. as a webcast on apple.com slash investor and via telephone. The number for the telephone replay is 866-583-1035. Please enter confirmation code 654-1285, followed by the pound sign. These replays will be available by approximately 5 p.m. Pacific time today. Members of the press with additional questions can contact Josh Rosenstock at 408-862-1142. Financial analysts can contact me with additional questions at 669-227-2402. Thank you again for joining us."
    }
  ]
}

Example 3: Get Level 3 Enhanced Transcript Data

Level 3 Transcripts include word level timestamps. Level 3 transcription data is included for all plans that contain enhanced transcription data.

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

Example 3: Output

{
  "event": {
    "year": 2023,
    "quarter": 1,
    "conference_date": "2023-02-02T17:00:00.000-05:00"
  },
  "speakers": [
    {
      "speaker": "spk12",
      "words": [
        "Good",
        "day,",
        "everyone,",
        "and",
        "welcome",
        "to",
        "the",
        "Apple",
        "Q1",
        "Fiscal",
        "Year",
        "2023",
        "Earnings",
        "Conference",
        "Call.",
        "Today's",
        "call",
        "is",
        "being",
        "recorded.",
        "And",
        "now",
        "at",
        "this",
        "time,",
        "for",
        "opening",
        "remarks",
        "and",
        "introductions,",
        "I",
        "would",
        "like",
        "to",
        "turn",
        "the",
        "call",
        "over",
        "to",
        "Teja",
        "Skala,",
        "Director",
        "of",
        "Investor",
        "Relations",
        "and",
        "Corporate",
        "Finance.",
        "Please",
        "go",
        "ahead."
      ],
      "start_times": [
        0.009,
        0.129,
        0.269,
        0.709,
        0.87,
        1.19,
        1.27,
        1.45,
        1.83,
        2.19,
        2.631,
        2.6409999999999996,
        3.031,
        4.232,
        4.672,
        5.312,
        5.712,
        6.093,
        6.273,
        6.493,
        6.993,
        7.674,
        7.874,
        7.974,
        8.174,
        8.514,
        8.854,
        9.235,
        9.755,
        9.935,
        10.595,
        10.655,
        10.796,
        10.916,
        10.996,
        11.216,
        11.316,
        11.576,
        11.856,
        12.096,
        12.817,
        13.717,
        14.238,
        14.358,
        14.778,
        15.618,
        15.799,
        16.179,
        17.159,
        17.42,
        17.62
      ]
    },
    {
      "speaker": "spk07",
      "words": [
        "Thank",
        "you.",
        "Speaking",
        "first",
        "today",
        "is",
        "Apple",
        "CEO",
        "Tim",
        "Cook,",
        "and",
        "he'll",
        "be",
        "followed",
        "by",
        "CFO",
        "Luca",
        "Maestri.",
        "After",
        "that,",
        "we'll",
        "open",
        "the",
        "call",
        "to",
        "questions",
        "from",
        "analysts.",
        "Before",
        "turning",
        "the",
        "call",
        "over",
        "to",
        "Tim,",
        "I",
        "would",
        "like",
        "to",
        "remind",
        "everyone",
        "that",
        "the",
        "December",
        "quarter",
        "spanned",
        "14",
        "weeks,",
        "while",
        "the",
        "March",
        "quarter,",
        "as",
        "usual,",
        "has",
        "13",
        "weeks.",
        "Please",
        "note",
        "that",
        "some",
        "of",
        "the",
        "information",
        "you'll",
        "hear",
        "during",
        "our",
        "discussion",
        "today",
        "will",
        "consist",
        "of",
        "forward-looking",
        "statements",
        "including,",
        "without",
        "limitation,",
        "those",
        "regarding",
        "revenue,",
        "gross",
        "margin,",
        "operating",
        "expenses,",
        "other",
        "income",
        "and",
        "expense,",
        "taxes,",
        "capital",
        "allocation,",
        "and",
        "the",
        "future",
        "business",
        "outlook,",
        "including",
        "the",
        "potential",
        "impact",
        "of",
        "COVID-19",
        "on",
        "the",
        "company's",
        "business",
        "and",
        "results",
        "of",
        "operations.",
        "These",
        "statements",
        "involve",
        "risks",
        "and",
        "uncertainties",
        "that",
        "may",
        "cause",
        "actual",
        "results",
        "or",
        "trends",
        "to",
        "differ",
        "materially",
        "from",
        "our",
        "forecast.",
        "For",
        "more",
        "information,",
        "please",
        "refer",
        "to",
        "the",
        "risk",
        "factors",
        "discussed",
        "in",
        "Apple's",
        "most",
        "recently",
        "filed",
        "annual",
        "report",
        "on",
        "Form",
        "10-K",
        "and",
        "the",
        "Form",
        "8-K",
        "filed",
        "with",
        "the",
        "SEC",
        "today,",
        "along",
        "with",
        "the",
        "associated",
        "press",
        "release.",
        "Apple",
        "assumes",
        "no",
        "obligation",
        "to",
        "update",
        "any",
        "forward-looking",
        "statements",
        "or",
        "information",
        "which",
        "speak",
        "as",
        "of",
        "their",
        "respective",
        "dates.",
        "I'd",
        "now",
        "like",
        "to",
        "turn",
        "the",
        "call",
        "over",
        "to",
        "Tim",
        "for",
        "introductory",
        "remarks."
      ],
      "start_times": [
        18.7,
        18.94,
        19.561,
        19.961,
        20.201,
        20.942,
        21.102,
        21.322,
        21.762,
        22.022,
        22.843,
        22.943,
        23.123,
        23.223,
        23.543,
        23.743,
        24.364,
        24.744,
        26.405,
        26.645,
        27.025,
        27.226,
        27.446,
        27.546,
        27.806,
        27.926,
        28.486,
        28.706,
        29.96,
        30.38,
        30.621,
        30.741,
        31.021,
        31.201,
        31.362,
        32.062,
        32.122,
        32.283,
        32.443,
        32.563,
        33.043,
        33.624,
        33.784,
        33.904,
        34.345,
        34.725,
        34.735,
        35.626,
        36.247,
        36.427,
        36.547,
        36.848,
        37.568,
        37.789,
        38.369,
        38.379,
        38.99,
        40.131,
        40.451,
        40.792,
        40.972,
        41.132,
        41.212,
        41.312,
        41.853,
        42.113,
        42.594,
        42.874,
        42.994,
        43.475,
        44.196,
        44.376,
        44.756,
        44.896,
        45.497,
        46.118,
        46.938,
        47.259,
        48.38,
        48.72,
        49.441,
        50.482,
        50.783,
        51.824,
        52.244,
        53.385,
        53.605,
        53.866,
        53.966,
        54.947,
        55.848,
        56.228,
        57.509,
        57.629,
        57.75,
        58.09,
        58.47,
        58.951,
        59.291,
        59.411,
        60.052,
        60.552,
        60.692,
        61.954,
        62.034,
        62.174,
        62.895,
        63.475,
        63.615,
        64.016,
        64.156,
        65.537,
        65.717,
        66.318,
        66.738,
        67.179,
        67.319,
        68.32,
        68.52,
        68.74,
        69.261,
        69.601,
        70.122,
        70.282,
        70.843,
        70.983,
        71.263,
        71.844,
        72.044,
        72.184,
        73.476,
        73.616,
        73.836,
        74.837,
        75.137,
        75.437,
        75.517,
        75.678,
        75.918,
        76.558,
        77.038,
        77.259,
        77.779,
        78.099,
        78.56,
        79.3,
        79.62,
        80.281,
        80.441,
        80.721,
        81.822,
        81.942,
        82.062,
        82.382,
        83.463,
        83.763,
        83.883,
        84.143,
        84.744,
        85.484,
        85.785,
        85.925,
        86.025,
        86.605,
        86.825,
        88.266,
        88.647,
        89.107,
        89.347,
        90.048,
        90.268,
        90.748,
        91.008,
        91.609,
        92.269,
        92.429,
        93.23,
        93.47,
        94.07,
        94.25,
        94.371,
        94.571,
        95.151,
        96.252,
        96.452,
        96.672,
        96.852,
        96.952,
        97.192,
        97.293,
        97.593,
        97.773,
        97.893,
        98.233,
        98.393,
        98.874
      ]
    }
  ]
}

Example 4: Get Prepared Remarks and Q&A

Level 4 Transcripts include prepared remarks and Q&A. Level 4 transcription data is included for all plans that contain enhanced transcription data.

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

Example 4: Output

{
  "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": "Our first question comes from Katie Huberty from Morgan Stanley. Please go ahead. Hello, Katie. Your..."
}

Get Full Company List

URL Endpoint :https://v2.api.earningscall.biz/symbols
HTTP Verb :GET
Parameter :"apikey" - We will give you a unique API Key to use. Please do not share this key with anyone. Use “demo” to try it out.
Result :JSON Array

HTTP Response Status Codes

200Success
401Missing or invalid API Key
403Not authorized to call this API
404Not found

Example Usage

curl https://v2.api.earningscall.biz/symbols?apikey=demo

Example Output

[
  {
    "exchange": "NASDAQ",
    "name": "Apple Inc.",
    "symbol": "AAPL"
  },
  {
    "exchange": "NASDAQ",
    "name": "Microsoft Corporation",
    "symbol": "MSFT"
  }
]

Get Audio File

URL Endpoint :https://v2.api.earningscall.biz/audio
HTTP Verb :GET
Parameter :"apikey" - We will give you a unique API Key to use. Please do not share this key with anyone. Use “demo” to try it out.
Parameter :"exchange" - Valid values: "NYSE", "NASDAQ", "AMEX", "TSX", "TSXV" or "OTC".
Parameter :"symbol" - The ticker symbol.
Parameter :"year" - The 4 digit year of the earnings call. Example value: "2024".
Parameter :"quarter" - Valid values: 1, 2, 3, or 4.
Result :audio/mpeg - audio data

HTTP Response Status Codes

200Success
401Missing or invalid API Key
403Not authorized to call this API
404Not found

Example Usage

curl --output msft_q1_2022.mp3 'https://v2.api.earningscall.biz/audio?apikey=demo&exchange=NASDAQ&symbol=MSFT&year=2022&quarter=1'

Example Output

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 28.1M  100 28.1M    0     0   410k      0  0:01:10  0:01:10 --:--:--  157k

Contact Us

Please contact us if you are interested in learning more about our APIs. You can email sales@earningscall.biz for more information, or fill out the below form.

Looks good!