Skip to content

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.

finance.yahoo.com (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by Yahoo.

Inputs

Values from the run on Oct 23, 2026, shown under Output.

Days optionaldays

Number of consecutive days to cover, such as 7. Defaults to 7; at most 14.

7

Whole number from 1 to 14. Default 7.

Company optionalcompany

Company name or ticker, such as Apple or AAPL. Returns its upcoming and last four reports instead of the date range.

Not set

Start Date optionalstart_date

First report date in the date range (YYYY-MM-DD), such as 2026-09-28. Defaults to today.

2026-09-28

Max Results optionalmax_results

Maximum reports to return, such as 50. Defaults to 50; at most 200.

50

Whole number from 1 to 200. Default 50.

Output

From a run on Oct 23, 2026, shortened for this page.
{  "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/"    }  ]}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
finance.yahoo.com/get_earnings_calendar
Returns
company name, ticker, report date, time of day, EPS estimate, reported EPS, surprise percent, link

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method finance.yahoo.com/get_earnings_calendar with the inputs above.

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.
  • 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.

    finance.yahoo.com/get_company_news
  • Shows analyst recommendations, price targets, earnings estimates and recent rating changes for a public company on Yahoo Finance.

    finance.yahoo.com/get_analyst_ratings
  • 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.com/search_news
  • Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency.

    finance.yahoo.com/get_price_history
  • 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.

    finance.yahoo.com/get_quote
  • 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.

    finance.yahoo.com/list_market_movers
  • 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.

    sports.yahoo.com/get_scores
  • 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.

    yahoo.com/list_headlines