Yahoo Finance Scraper

Scrape real-time and historical stock market data from Yahoo Finance without official API limits. Extract financial statements, earnings reports, historical prices, and company fundamentals for investment analysis and trading research.

Features

• Real-Time Quotes: Current price, bid/ask spreads, market cap, and trading volume
• Financial Statements: Income statements, balance sheets, cash flow data (quarterly and annual)
• Historical Price Data: Daily OHLCV (open, high, low, close, volume) data for any date range
• Earnings Data: Historical earnings dates, actual vs. estimated EPS, earnings surprises
• Company Fundamentals: P/E ratio, dividend yield, 52-week highs/lows, analyst ratings
• Multi-Ticker Support: Process multiple stock symbols in a single run
• Structured JSON Output: Ready for data warehouses, dashboards, or trading systems

Input Parameters

Parameter	Type	Required	Description	Default
tickers	Array	Yes	Stock symbols to scrape (e.g., ["AAPL", "GOOGL", "MSFT"])	[]
includeHistorical	Boolean	No	Include historical daily price data	false
historicalDays	Integer	No	Number of days of history (1-5000)	250
includeFinancials	Boolean	No	Include financial statements	true
includeEarnings	Boolean	No	Include earnings data and estimates	true

Output

Field	Type	Description
symbol	String	Stock ticker symbol
name	String	Company full name
price	Number	Current stock price
currency	String	Price currency (USD, etc.)
marketCap	String	Market capitalization
peRatio	Number	Price-to-earnings ratio
dividendYield	Number	Annual dividend yield
fiftyTwoWeekHigh	Number	52-week high price
fiftyTwoWeekLow	Number	52-week low price
volume	Integer	Daily trading volume
earnings	Array	Historical earnings data
financials	Object	Balance sheet, income statement, cash flow
historicalPrices	Array	Daily OHLCV data

Use Cases

• Investment Portfolio Analysis: Track fundamentals and performance across holdings
• Algorithmic Trading: Feed real-time data into trading models and backtesting systems
• Financial Dashboard: Build interactive dashboards with current and historical data
• Earnings Analysis: Monitor earnings dates, surprises, and analyst revisions
• Fundamental Screening: Filter stocks by P/E, dividend yield, market cap criteria
• Data Warehouse: Populate financial data lakes for BI and analytics platforms

Example Output

{
  "symbol": "AAPL",
  "name": "Apple Inc.",
  "price": 182.45,
  "currency": "USD",
  "marketCap": "2.84T",
  "peRatio": 28.5,
  "dividendYield": 0.0043,
  "fiftyTwoWeekHigh": 199.62,
  "fiftyTwoWeekLow": 164.08,
  "volume": 52348900,
  "earnings": [
    {
      "date": "2024-01-30",
      "epsActual": 1.95,
      "epsEstimate": 1.87,
      "surprise": 0.08
    }
  ],
  "financials": {
    "totalRevenue": 394328000000,
    "netIncome": 96995000000,
    "operatingCashFlow": 110543000000
  },
  "historicalPrices": [
    {
      "date": "2024-02-17",
      "open": 181.52,
      "high": 183.14,
      "low": 181.40,
      "close": 182.45,
      "volume": 52348900
    }
  ]
}

Limitations

• Historical data limited to ~5000 days maximum (approximately 19 years)
• Some delisted or private companies may not have complete data
• Earnings surprise data only available for dates with actual earnings releases
• Dividend history limited to recent years for some companies
• Real-time data has slight delay (15-20 minute Yahoo Finance standard delay)

Cost & Performance

Typical runs cost $0.10-$0.50 in platform credits for 10-50 tickers with full financials. Processing time: ~1-3 minutes depending on historical date range.

---

Built by nexgendata. For questions or issues, check the documentation or contact us.