Earnings Call Transcript API
The Earnings Call Transcript API provides access to full transcripts of earnings calls for major companies every quarter. Most transcripts are available within a few hours of the earnings call being finished.
This API covers over 8,000 companies, current and delisted. Historical earnings call transcript data is available from 2005 onwards for many companies.
Available endpoints:
- /v1/earningstranscript - Get the earnings transcript for a given company earning quarter
- /v1/earningstranscriptsearch - Search for available earnings call transcripts by ticker, CIK, date, or date range, with paginated results
- /v1/earningstranscriptlist - Get a list of all companies with earnings transcripts
- /v1/earningstranscriptspeaker - Search earnings call speakers (executives and analysts), or look up one speaker's full profile and appearance history by id
- /v1/earningstranscriptparticipants - List the executives and analysts who appeared on a company's earnings calls
From 6,524 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 211ms | 258ms | 268ms | 564ms | 1154ms |
Similar APIs
Didn't find what you were looking for? Suggest an improvement
/v1/earningstranscript GETPremium Only
https://api.api-ninjas.com/v1/earningstranscript
Returns the earnings transcript for a given company earning quarter.
Developer tier includes transcripts from the most recent 5 years; the complete archive (2005 onwards) is available to Business and Professional subscribers. See pricing.
Parameters
Either ticker or cik must be provided. If year and quarter are not provided, the latest earnings call transcript will be returned.
tickeroptionalCompany ticker symbol (e.g.,
AAPL).cikoptionalCompany Central Index Key (e.g.,
320193).yearoptionalEarnings year (e.g.,
2026). Must be a valid year between 2000 and the current year. If provided,quartermust also be provided.quarteroptionalEarnings quarter from Q1 to Q4. Must be one of the following values:
1,2,3,4. If provided,yearmust also be provided.qa_onlyoptionalIf set to
true, restrictstranscript_split(and the rebuilttranscriptstring) to analyst Q&A turns only, omitting prepared remarks.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON object with the following fields or an error if the request is unsuccessful.
dateThe date of the earnings call.
timestampThe UNIX timestamp (in seconds) of the earnings call to the nearest minute.
tickerThe ticker symbol of the company.
cikThe CIK of the company.
yearThe year of the earnings call.
quarterThe quarter of the earnings call.
earnings_timingTiming of the earnings call. Possible values are:
before_market: Earnings call occurs before the market opens.during_market: Earnings call occurs during regular market hours.after_market: Earnings call occurs after the market closes.
transcriptThe transcript of the earnings call as a single string.
participantsBusiness and Professional tier subscribers onlyThe list of participants of the earnings call. Each participant is an object with
name,role, andcompanyproperties.summaryBusiness and Professional tier subscribers onlyA concise summary of the earnings call, covering the main points discussed including financial performance, key metrics, and strategic initiatives.
guidanceBusiness and Professional tier subscribers onlyAny forward-looking guidance issued by the company during the call, including revenue projections, earnings estimates, margin expectations, or other forecasts. Empty string if no guidance was provided.
risk_factorsBusiness and Professional tier subscribers onlyAny risk factors, challenges, headwinds, or concerns mentioned during the call that could negatively impact the company's future performance. Empty string if no risk factors were mentioned.
overall_sentimentBusiness and Professional tier subscribers onlyThe overall sentiment of the entire transcript on a scale from
-1(very negative) to1(very positive), where0is neutral.overall_sentiment_rationaleBusiness and Professional tier subscribers onlyA brief explanation of the overall sentiment score, including key positive signals, key negative signals, and the reasoning behind the score.
transcript_splitBusiness and Professional tier subscribers onlyThe transcript of the earnings call split into sections by speaker. Each section includes:
speaker- Speaker's namecompany- Company the speaker representsrole- Role/title of the speakertext- Speaker's remarkssentiment- Sentiment score for this segment from-1(very negative) to1(very positive)sentiment_rationale- Brief explanation of the sentiment scorespeaker_type- Type of speaker: "management", "investor", or "operator"is_qa- Boolean indicating if this segment is part of the Q&A portion
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/earningstranscript?ticker=AAPLHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/earningstranscript?ticker=AAPL" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
/v1/earningstranscriptsearch GETPremium Only
https://api.api-ninjas.com/v1/earningstranscriptsearch
Returns a list of available earnings call transcripts for a given company, date, or date range. Use ticker, CIK, a single date, or a start_date/end_date window to search. Results are paginated and sorted by call date (most recent first).
Parameters
At least one of ticker, cik, date, or start_date/end_date must be provided.
tickeroptionalCompany ticker symbol (e.g.,
AAPL).cikoptionalCompany Central Index Key (e.g.,
789019). For US companies registered with the SEC only.dateoptionalFilter results by earnings call date in YYYY-MM-DD format (e.g.,
2024-05-02). Mutually exclusive withstart_date/end_date.start_dateoptionalStart of the earnings call date range (inclusive), in YYYY-MM-DD format. Must be paired with
end_date. When bothtickerandcikare omitted, the range cannot exceed 30 days.end_dateoptionalEnd of the earnings call date range (inclusive), in YYYY-MM-DD format. Must be paired with
start_date.limitoptionalMaximum number of results to return. Default
20; values above200are clamped to200.offsetoptionalNumber of results to skip, for pagination. Default
0.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.
tickerThe company ticker symbol.
yearThe year of the earnings call transcript (as a string).
quarterThe quarter of the earnings call transcript (as a string:
1,2,3, or4).dateThe earnings call date in YYYY-MM-DD format (e.g.,
2024-05-02).
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/earningstranscriptsearch?ticker=AAPLHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
/v1/earningstranscriptlist GETPremium Only
https://api.api-ninjas.com/v1/earningstranscriptlist
Returns a list of all companies with earnings transcripts.
Note: Use /v1/earningstranscriptsearch to find the list of transcripts for a given company.
Parameters
limitoptionalNumber of results to return. Default is unlimited - all results will be returned.
offsetoptionalNumber of results to skip for pagination. Default:
0.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.
tickerThe company ticker symbol.
companyThe company name.
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/earningstranscriptlist?limit=50&offset=0Headers
X-Api-KeyLog in or sign up to get your API KeySample Response
/v1/earningstranscriptspeaker GETBusiness & Professional
https://api.api-ninjas.com/v1/earningstranscriptspeaker
One endpoint with two modes. Without an id, it searches the people who appear on earnings calls (company executives and sell-side analysts) and returns a paginated list. With an id, it returns that single speaker's full profile, a per-company coverage rollup, and their paginated appearance history.
Parameters
idoptionalA
speaker_idreturned by a previous search. When set, the endpoint runs in detail mode and the search filters below are ignored (exceptticker,year,quarter,limit, andoffset, which filter and paginate the appearance list).nameoptionalCase-insensitive substring match on the speaker's name (search mode).
companyoptionalSubstring match on an executive's primary company (search mode).
analyst_firmoptionalSubstring match on an analyst's firm (search mode).
roleoptionalSubstring match on role or title, e.g.
CEO(search mode).speaker_typeoptionalFilter by type:
executiveoranalyst(search mode).tickeroptionalIn search mode, restrict to people who appeared on this company's calls. In detail mode, filter the appearance list to this company.
year/quarteroptionalFilter by fiscal year and quarter (1-4). In search mode,
quarterrequiresyear.sort_by/sort_diroptionalSearch-mode sort.
sort_byis one ofappearance_count(default),last_appearance_date, orname;sort_dirisascordesc.include_appearancesoptionalWhen
true(search mode), include each returned speaker's appearance list.limit/offsetoptionalPagination. Search mode: speakers per page (default
25, max100). Detail mode: appearances per page (default50, max200).
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
In search mode, a JSON object with a speakers array and a pagination object. In detail mode, a single speaker object (an empty object {} if the id is unknown). Each speaker object contains:
speaker_idStable identifier for the person. Pass it back as
idto fetch full detail.name,speaker_type,primary_role,role_variantsDisplay name;
executiveoranalyst; most common title; and all observed titles.primary_company,primary_company_ticker,primary_cik,analyst_firmFor executives, the company they represent; for analysts, their most recent firm.
appearance_count,distinct_companies,distinct_tickers,first_appearance_date,last_appearance_dateAggregate participation stats across all calls.
coveragedetail modePer-company rollup:
ticker,cik,appearance_count, and first/last appearance dates for each company the person engaged with.appearances/appearances_paginationdetail modeThe paginated list of calls the person appeared on, each with
transcript_id,ticker,year,quarter,date,role, andturn_count. Also present in search mode wheninclude_appearances=true.
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/earningstranscriptspeaker?name=Tim+CookHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
/v1/earningstranscriptparticipants GETBusiness & Professional
https://api.api-ninjas.com/v1/earningstranscriptparticipants
Returns the people who appeared on a given company's earnings calls - executives and sell-side analysts - with stats scoped to that company. Use speaker_type=executive for the management roster or speaker_type=analyst for the analysts who cover the stock.
Parameters
Either ticker or cik must be provided.
tickeroptionalCompany ticker symbol (e.g.,
AAPL).cikoptionalCompany Central Index Key (e.g.,
320193).speaker_typeoptionalRestrict to
executive(management roster) oranalyst(covering analysts).sort_by/sort_diroptionalsort_byis one ofappearance_count(default),last_appearance_date, orname;sort_dirisascordesc.limit/offsetoptionalPagination. Default
limit50(max200);offsetdefault0.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON object with ticker, cik, a participants array, and a pagination object, or an error if the request is unsuccessful. Each participant contains:
speaker_id,name,speaker_typeThe person's stable id, display name, and whether they are an
executiveoranalyst.role,analyst_firmMost recent role on this company's calls, and the analyst's firm (analysts only).
appearance_count,first_appearance_date,last_appearance_dateNumber of this company's calls the person appeared on, and the date range - all scoped to this company.
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/earningstranscriptparticipants?ticker=AAPLHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
Frequently Asked Questions
Can I use the Earnings Call Transcript API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Earnings Call Transcript API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the Earnings Call Transcript API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the Earnings Call Transcript API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.What companies and time range does the Earnings Call Transcript API cover?
The API covers over 8,000 companies (current and delisted) globally with a focus on US large, mid, and small cap stocks, and historical transcripts are available from 2005 onwards for many companies. Use the Earnings Calendar API to find upcoming report dates and pair it with this API to fetch each call once it is published.How do I fetch the transcript for a specific company quarter?
Call the/v1/earningstranscriptendpoint with either aticker(e.g.AAPL) or acik, and addyearandquarter(1to4) to target a specific call; if you omityearandquarterthe latest transcript is returned. See pricing for the tiers required, since these endpoints are premium only.What does the transcript response include beyond the raw text?
Besides the fulltranscriptstring and call metadata likedate,quarter, andearnings_timing, Business and Professional tiers also return asummary, extractedguidanceandrisk_factors, anoverall_sentimentscore from-1to1, and atranscript_splitarray that breaks the call into per-speaker turns with their ownsentimentand anis_qaflag. To pull only the analyst Q&A turns, setqa_onlytotrue; for the underlying financial figures see the Earnings API.How do I find which transcripts exist and who spoke on a company's calls?
Use/v1/earningstranscriptsearchwith aticker,cik,date, or astart_date/end_datewindow to list available transcripts (paginated, most recent first), and use/v1/earningstranscriptparticipantswithspeaker_type=executiveorspeaker_type=analystto get the management roster or covering analysts for a company. For a person's full cross-company history, look them up byidon/v1/earningstranscriptspeaker; see the related API directory for more finance data.