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
HTTP Response Status Codes
Example Usage
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
HTTP Response Status Codes
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.
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.
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.
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.
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
HTTP Response Status Codes
Example Usage
Example Output
[ { "exchange": "NASDAQ", "name": "Apple Inc.", "symbol": "AAPL" }, { "exchange": "NASDAQ", "name": "Microsoft Corporation", "symbol": "MSFT" } ]
Get Audio File
HTTP Response Status Codes
Example Usage
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.