# Yahoo API: Get earnings calendar > Gets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company. Unofficial. Not affiliated with or endorsed by Yahoo. - Page: https://fous.com/methods/finance.yahoo.com/get-earnings-calendar - Method: `finance.yahoo.com/get_earnings_calendar`, version 1 - Website: finance.yahoo.com - Returns: company name, ticker, report date, time of day, EPS estimate, reported EPS, surprise percent, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `days` | integer | no | `7` | Number of consecutive days to cover, such as 7. Defaults to 7; at most 14. Default 7. | | `company` | string | no | | Company name or ticker, such as Apple or AAPL. Returns its upcoming and last four reports instead of the date range. | | `start_date` | string | no | `"2026-09-28"` | First report date in the date range (YYYY-MM-DD), such as 2026-09-28. Defaults to today. | | `max_results` | integer | no | `50` | Maximum reports to return, such as 50. Defaults to 50; at most 200. Default 50. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "days": 7, "start_date": "2026-09-28", "max_results": 50 } ``` Its output: ```json { "earnings_reports": [ { "ticker": "JEF", "report_date": "2026-09-28", "time_of_day": "not supplied", "company_name": "Jefferies Financial Group Inc.", "eps_estimate": 1, "reported_eps": 1.08, "surprise_percent": 8.01, "yahoo_finance_link": "https://finance.yahoo.com/quote/JEF/" }, { "ticker": "MTN", "report_date": "2026-09-28", "time_of_day": "not supplied", "company_name": "Vail Resorts, Inc.", "eps_estimate": -5.35, "reported_eps": -5.34, "surprise_percent": 0.17, "yahoo_finance_link": "https://finance.yahoo.com/quote/MTN/" }, { "ticker": "AIR", "report_date": "2026-09-28", "time_of_day": "not supplied", "company_name": "AAR Corp.", "eps_estimate": 1.29, "reported_eps": 1.49, "surprise_percent": 15.5, "yahoo_finance_link": "https://finance.yahoo.com/quote/AIR/" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"finance.yahoo.com/get_earnings_calendar","input":{"days":7,"start_date":"2026-09-28","max_results":50}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What earnings reports are coming up for Nvidia, and how do its last four EPS results compare to estimates? - Show me the earnings calendar for the 10 days starting 2026-10-05, limited to 25 reports. - Which companies report earnings this week, with their EPS estimates and time of day? - On Yahoo Finance, list the upcoming earnings dates for Microsoft plus its previous four reports with surprise percentages. - Give me all earnings releases between 2026-09-14 and the next 14 days, capped at 100 entries, with reported vs. estimated EPS. ## Input schema ```json { "type": "object", "properties": { "days": { "type": "integer", "default": 7, "maximum": 14, "minimum": 1, "description": "Number of consecutive days to cover, such as 7. Defaults to 7; at most 14." }, "company": { "type": "string", "description": "Company name or ticker, such as Apple or AAPL. Returns its upcoming and last four reports instead of the date range." }, "start_date": { "type": "string", "description": "First report date in the date range (YYYY-MM-DD), such as 2026-09-28. Defaults to today." }, "max_results": { "type": "integer", "default": 50, "maximum": 200, "minimum": 1, "description": "Maximum reports to return, such as 50. Defaults to 50; at most 200." } } } ``` ## Output schema ```json { "type": "object", "required": [ "earnings_reports" ], "properties": { "earnings_reports": { "type": "array", "items": { "type": "object", "properties": { "ticker": { "type": "string" }, "report_date": { "type": "string" }, "time_of_day": { "enum": [ "before market open", "after market close", "not supplied" ], "type": "string" }, "company_name": { "type": [ "string", "null" ] }, "eps_estimate": { "type": [ "number", "null" ] }, "reported_eps": { "type": [ "number", "null" ] }, "surprise_percent": { "type": [ "number", "null" ] }, "yahoo_finance_link": { "type": "string" } } } } } } ``` ## See more - [Yahoo API: Get company news](https://fous.com/methods/finance.yahoo.com/get-company-news.md): Looks up a company by name or ticker on Yahoo Finance and returns its latest news headlines, with article summaries when the article page provides one. - [Yahoo API: Get analyst ratings](https://fous.com/methods/finance.yahoo.com/get-analyst-ratings.md): Shows analyst recommendations, price targets, earnings estimates and recent rating changes for a public company on Yahoo Finance. - [Yahoo API: Search Yahoo News](https://fous.com/methods/yahoo.com/search-news.md): Searches Yahoo News articles by keyword, newest first or by relevance, with optional publication dates and pages; returns only articles hosted on Yahoo News, with authors, original publisher and section. - [Yahoo API: Get price history](https://fous.com/methods/finance.yahoo.com/get-price-history.md): Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency. - [Yahoo API: Get quote](https://fous.com/methods/finance.yahoo.com/get-quote.md): Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed. - [Yahoo API: List market movers](https://fous.com/methods/finance.yahoo.com/list-market-movers.md): Lists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap. - [Yahoo API: Get scores](https://fous.com/methods/sports.yahoo.com/get-scores.md): Gets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games. - [Yahoo API: List Yahoo News headlines](https://fous.com/methods/yahoo.com/list-headlines.md): Lists the latest Yahoo News headlines for a section in page order, with summary, byline, original publisher, image and publication time when the article provides them. - [All Yahoo methods](https://fous.com/methods/yahoo.com.md)