Yahoo Finance Scraper API

Real-time Yahoo Finance data — stock quotes, historical prices, financial statements, earnings, analyst recommendations, options chains, and news. All data is scraped directly from Yahoo Finance and returned as structured JSON.

7 Endpoints REST API JSON 99.9% Uptime
Start Free on RapidAPI → View Endpoints ↓

Try it instantly

See real data shapes from every endpoint — no signup required.

Request
GET /yahoo-finance/quote
symbol AAPL required 
curl -G "https://api.pullapi.com/yahoo-finance/quote" \
  -H "x-rapidapi-key: YOUR_API_KEY"
Response 200 OK 
{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "price": 178.72,
    "change": 2.15,
    "change_percent": 1.2173,
    "previous_close": 176.57,
    "open": 177.09,
    "day_high": 179.43,
    "day_low": 176.81,
    "fifty_two_week_high": 199.62,
    "fifty_two_week_low": 143.9,
    "volume": 54823190,
    "avg_volume": 58241300,
    "market_cap": "2.78T",
    "pe_ratio": 28.45,
    "eps": 6.28,
    "dividend_yield": 0.53,
    "beta": 1.24,
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "exchange": "NMS",
    "currency": "USD"
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

API Endpoints

7 endpoints across 5 categories.

Quote

GET /yahoo-finance/quote

Get a real-time stock quote including current price, price change, volume, market cap, PE ratio, EPS, dividend yield, beta, sector, and industry. Combines data from Yahoo Finance's chart API and the HTML quote page for comprehensive coverage.

Parameters

Name Type Required Description Example
symbol string Yes Stock ticker symbol. Examples: "AAPL", "MSFT", "GOOGL", "TSLA". The $ prefix and whitespace are... AAPL

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "price": 178.72,
    "change": 2.15,
    "change_percent": 1.2173,
    "previous_close": 176.57,
    "open": 177.09,
    "day_high": 179.43,
    "day_low": 176.81,
    "fifty_two_week_high": 199.62,
    "fifty_two_week_low": 143.9,
    "volume": 54823190,
    "avg_volume": 58241300,
    "market_cap": "2.78T",
    "pe_ratio": 28.45,
    "eps": 6.28,
    "dividend_yield": 0.53,
    "beta": 1.24,
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "exchange": "NMS",
    "currency": "USD"
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Historical

GET /yahoo-finance/historical

Get historical OHLCV (Open, High, Low, Close, Volume) price data for a stock. Supports configurable time ranges from 1 day to max history and intervals from 1 minute to 3 months. Includes adjusted close prices when available.

Parameters

Name Type Required Description Example
symbol string Yes Stock ticker symbol. Examples: "AAPL", "MSFT", "GOOGL" AAPL
range string No Time range for historical data. Determines how far back to retrieve prices. 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
interval string No Data interval (candle size). Intraday intervals (1m-90m) are only available for short ranges (1d-5d). 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "range": "1mo",
    "interval": "1d",
    "prices": [
      {
        "date": "2026-02-14 00: 00: 00",
        "open": 172.35,
        "high": 174.82,
        "low": 171.9,
        "close": 174.55,
        "adj_close": 174.55,
        "volume": 51234567
      },
      {
        "date": "2026-02-18 00: 00: 00",
        "open": 174.8,
        "high": 176.21,
        "low": 174.1,
        "close": 175.9,
        "adj_close": 175.9,
        "volume": 48921034
      }
    ]
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Fundamentals

GET /yahoo-finance/financials

Get annual and quarterly income statement data for a company, including total revenue, net income, gross profit, operating income, EBITDA, and total expenses. Data is extracted from Yahoo Finance's embedded financial data.

Parameters

Name Type Required Description Example
symbol string Yes Stock ticker symbol. Examples: "AAPL", "MSFT", "GOOGL" AAPL

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "annual": [
      {
        "date": "2025-09-27",
        "total_revenue": 394328000000,
        "net_income": 97150000000,
        "gross_profit": 175230000000,
        "operating_income": 123450000000,
        "ebitda": 135670000000,
        "total_expenses": 270878000000
      },
      {
        "date": "2024-09-28",
        "total_revenue": 383285000000,
        "net_income": 93736000000,
        "gross_profit": 170782000000,
        "operating_income": 118658000000,
        "ebitda": 130541000000,
        "total_expenses": 264627000000
      }
    ],
    "quarterly": [
      {
        "date": "2025-12-27",
        "total_revenue": 124300000000,
        "net_income": 36330000000,
        "gross_profit": 58375000000,
        "operating_income": 42832000000,
        "ebitda": 46120000000,
        "total_expenses": 81468000000
      }
    ]
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}
GET /yahoo-finance/earnings

Get earnings data including quarterly EPS history (estimate vs actual with surprise percentage) and upcoming earnings dates with EPS estimates. Useful for tracking earnings beats/misses and planning around earnings announcements.

Parameters

Name Type Required Description Example
symbol string Yes Stock ticker symbol. Examples: "AAPL", "MSFT", "GOOGL" AAPL

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "eps_history": [
      {
        "date": "4Q2025",
        "eps_estimate": 2.35,
        "eps_actual": 2.4,
        "surprise_percent": 2.13
      },
      {
        "date": "3Q2025",
        "eps_estimate": 1.58,
        "eps_actual": 1.64,
        "surprise_percent": 3.8
      },
      {
        "date": "2Q2025",
        "eps_estimate": 1.5,
        "eps_actual": 1.53,
        "surprise_percent": 2.0
      },
      {
        "date": "1Q2025",
        "eps_estimate": 1.42,
        "eps_actual": 1.46,
        "surprise_percent": 2.82
      }
    ],
    "earnings_dates": [
      {
        "date": "2026-04-30",
        "eps_estimate": 1.62
      },
      {
        "date": "2026-05-05",
        "eps_estimate": 1.62
      }
    ]
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}
GET /yahoo-finance/analyst

Get Wall Street analyst recommendations and price targets for a stock, including consensus recommendation (buy/hold/sell), mean/median/high/low price targets, and the number of analysts covering the stock.

Parameters

Name Type Required Description Example
symbol string Yes Stock ticker symbol. Examples: "AAPL", "MSFT", "GOOGL" AAPL

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "recommendation": "buy",
    "target_mean": 205.43,
    "target_high": 250.0,
    "target_low": 165.0,
    "target_median": 210.0,
    "num_analysts": 38
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Options

GET /yahoo-finance/options

Get the full options chain for a stock including calls and puts with strike prices, last price, bid/ask, volume, open interest, and implied volatility. Optionally specify an expiration date; defaults to the nearest available expiry.

Parameters

Name Type Required Description Example
symbol string Yes Stock ticker symbol. Examples: "AAPL", "MSFT", "GOOGL" AAPL
expiration string No Expiration date as a Unix timestamp (seconds since epoch). Omit to get the nearest available... 1711065600

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "expiration_date": "March 21, 2026",
    "calls": [
      {
        "strike": 170.0,
        "last_price": 9.85,
        "bid": 9.7,
        "ask": 10.0,
        "change": 0.45,
        "volume": 12543,
        "open_interest": 28341,
        "implied_volatility": "24.51%"
      },
      {
        "strike": 175.0,
        "last_price": 5.92,
        "bid": 5.8,
        "ask": 6.05,
        "change": 0.3,
        "volume": 18920,
        "open_interest": 35412,
        "implied_volatility": "22.83%"
      }
    ],
    "puts": [
      {
        "strike": 170.0,
        "last_price": 1.23,
        "bid": 1.18,
        "ask": 1.28,
        "change": -0.15,
        "volume": 8934,
        "open_interest": 19234,
        "implied_volatility": "23.15%"
      },
      {
        "strike": 175.0,
        "last_price": 3.1,
        "bid": 3.0,
        "ask": 3.2,
        "change": -0.22,
        "volume": 15432,
        "open_interest": 42310,
        "implied_volatility": "21.97%"
      }
    ]
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

News

GET /yahoo-finance/news

Get the latest news articles related to a stock ticker. Returns article titles, publishers, links, publication dates, and thumbnail images from Yahoo Finance's ticker news stream.

Parameters

Name Type Required Description Example
symbol string Yes Stock ticker symbol. Examples: "AAPL", "MSFT", "GOOGL" AAPL

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "articles": [
      {
        "title": "Apple Reports Record Q1 Revenue Driven by iPhone Sales",
        "publisher": "Reuters",
        "link": "https://finance.yahoo.com/news/apple-reports-record-q1-revenue-123456.html",
        "published_at": "2026-03-15T10: 30: 00Z",
        "thumbnail": "https://s.yimg.com/uu/api/res/1.2/example_thumb.jpg"
      },
      {
        "title": "Why Apple Stock Could Reach $250 This Year",
        "publisher": "Motley Fool",
        "link": "https://finance.yahoo.com/news/why-apple-stock-could-reach-250-654321.html",
        "published_at": "2026-03-15T08: 15: 00Z",
        "thumbnail": "https://s.yimg.com/uu/api/res/1.2/example_thumb2.jpg"
      },
      {
        "title": "Apple Expands AI Features Across Product Line",
        "publisher": "Bloomberg",
        "link": "https://finance.yahoo.com/news/apple-expands-ai-features-789012.html",
        "published_at": "2026-03-14T16: 45: 00Z",
        "thumbnail": null
      }
    ]
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Code Examples

Get started in seconds with your preferred language.

Terminal 
curl -G "https://api.pullapi.com/yahoo-finance/quote?symbol=AAPL" \
  -H "x-rapidapi-host: yahoo-finance-scraper-api.p.rapidapi.com" \
  -H "x-rapidapi-key: YOUR_API_KEY"

Why PullAPI

</>

No Browser Needed

HTTP-based API. No Selenium, no Puppeteer, no headless browsers to manage.

⇄

Built-in Proxy Rotation

Automatic residential proxy rotation handles anti-bot detection for you.

⚡

Cached Responses

Smart Redis caching means faster repeated queries and lower costs.

$

Pay Per Request

No monthly commitment. Free tier included. Pay only for what you use.

Use Cases

What developers build with the Yahoo Finance Scraper API.

1

Stock Research

2

Portfolio Tracking

3

Market Analysis

4

Trading Signals

Related Scrapers

More APIs in Finance.

CoinMarketCap

CoinMarketCap Scraper

Crypto Research · Market Monitoring

Amazon Scraper

Price Monitoring · Competitor Analysis
eBay

eBay Scraper

Price Tracking · Seller Research
Shopify

Shopify Scraper

Store Research · Product Intelligence

Walmart Scraper

Price Monitoring · Product Research
Google News

Google News Scraper

Media Monitoring · Trend Detection

Ready to scrape Yahoo Finance data?

Start with the free tier. No credit card required.

Subscribe on RapidAPI →