Yahoo Finance Scraper — Stock Quotes, ETFs & Financials 📈

🎉 Pull live market data AND company fundamentals for hundreds of tickers in a single run

Built for traders, quant researchers, analysts and fintech builders who need clean, structured Yahoo Finance data — no account, no API key.

---

📋 Overview

Turn Yahoo Finance into a clean, structured dataset — live quotes, valuation metrics, company fundamentals and price-history coverage for stocks, ETFs, indices, currencies and crypto, in bulk.

Why thousands of professionals choose us:

• ✅ Market data + fundamentals in one tool: Price, change %, market cap and 52-week range, plus sector, employees, analyst targets and revenue — no second tool needed.
• ⚡ Bulk by design: Look up hundreds of tickers per run with a single, fast batched request.
• 🎯 Search-to-tickers discovery: Type a theme like "electric vehicle" or "semiconductors" and the actor resolves the matching tickers for you.
• 💰 Pay-per-result: Only successful rows are billed — failed or invalid tickers are never charged.
• 💎 Every asset class: Stocks (AAPL), ETFs (SPY), indices (^GSPC), currencies (EURUSD=X) and crypto (BTC-USD).
• ✨ NEW: Detail mode adds full company profiles, analyst recommendations and price-history coverage.

---

✨ Features

• 📊 Overview Mode: Fast, batched market quote per ticker — price, change %, market cap, 52-week high/low, day range, volume, trailing/forward P/E, dividend yield, EPS and book value.
• 🏢 Detail Mode: Everything in Overview plus sector, industry, HQ location, website, employees, business summary, analyst mean target, recommendation, profit margins and total revenue.
• 🔍 Search Discovery: Resolve tickers from a plain-text query — perfect for thematic screening.
• 🚀 Bulk Input: Single ticker, an array, a paste-list, or pasted Yahoo Finance quote URLs — all auto-deduplicated.
• 📈 Price History Coverage: Choose a window (1 day → max) and granularity for historical sampling in Detail mode.
• 🌐 Every Asset Class: Equities, ETFs, indices, FX pairs and cryptocurrencies.
• 💾 Clean Exports: One flat row per ticker — export to JSON, CSV or Excel in a click.
• 🛡️ No Account Needed: No login, no API key, no setup.

---

🎬 Quick Start

Pick a mode, drop in one or many tickers (or a search query), and run. Results land in the dataset as one clean row per ticker, ready to export.

curl -X POST https://api.apify.com/v2/acts/sian.agency~yahoo-finance-scraper/runs?token=YOUR_TOKEN \
-H 'Content-Type: application/json' \
-d '{"mode": "overview", "symbols": ["AAPL", "MSFT", "GOOGL"]}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose your mode

Pick Overview for fast market data, or Detail for full company profiles and financials.

Step 2: Add tickers

Type a single ticker, paste a list, add an array, or enter a search query to discover tickers automatically.

Step 3: Run and export

Start the actor and download your results as JSON, CSV or Excel.

That's it! In seconds, you'll have:

• Live prices and valuation metrics for every ticker
• Company fundamentals (Detail mode)
• A clean dataset ready for your dashboard or spreadsheet

---

📥 Input Configuration

Field	Type	Required	Description
mode	string	No	overview (market quote) or detail (full profile + financials)
symbol	string	No	A single ticker, e.g. AAPL
symbols	array	No	A list of tickers for bulk lookup
bulkSymbols	string	No	Paste many tickers (comma / space / newline separated)
query	string	No	Search text to resolve tickers automatically
searchLimit	integer	No	How many tickers a query resolves (1–50)
includeChart	boolean	No	Detail mode: include price-history coverage
chartRange	string	No	Price-history window (1d…max)
chartInterval	string	No	Price-history granularity (1m…3mo)
proxyCountry	string	No	Optional 2-letter country for proxy rotation

Example (Overview — bulk):

{
  "mode": "overview",
  "symbols": ["AAPL", "MSFT", "GOOGL", "TSLA", "NVDA"]
}

Example (Detail — full profile):

{
  "mode": "detail",
  "symbols": ["AAPL", "MSFT"],
  "chartRange": "1mo"
}

Example (Search discovery):

{
  "mode": "overview",
  "query": "electric vehicle",
  "searchLimit": 10
}

---

📤 Output

Results are saved to the Apify dataset with 40+ fields including:

Field	Type	Description
id	string	Ticker symbol
title	string	Company / instrument name
price	number	Latest market price
currency	string	Price currency
change_percent	number	Regular-market change %
market_cap	integer	Market capitalization
quote_type	string	EQUITY, ETF, INDEX, CURRENCY, CRYPTOCURRENCY
fifty_two_week_high	number	52-week high
fifty_two_week_low	number	52-week low
trailing_pe	number	Trailing P/E ratio
dividend_yield	number	Dividend yield (%)
sector	string	Business sector (Detail mode)
employees	integer	Full-time employees (Detail mode)
target_mean_price	number	Analyst mean target (Detail mode)
recommendation	string	Analyst recommendation (Detail mode)
total_revenue	integer	Total revenue (Detail mode)

Example:

{
  "id": "AAPL",
  "url": "https://finance.yahoo.com/quote/AAPL/",
  "source": "summary",
  "title": "Apple Inc.",
  "price": 298.52,
  "currency": "USD",
  "change_percent": 0.5,
  "market_cap": 4384469286912,
  "quote_type": "EQUITY",
  "exchange": "NasdaqGS",
  "fifty_two_week_high": 317.4,
  "fifty_two_week_low": 199.26,
  "trailing_pe": 36.14,
  "dividend_yield": 0.36,
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "location": "Cupertino, United States",
  "website": "https://www.apple.com",
  "employees": 166000,
  "target_mean_price": 314.42,
  "recommendation": "buy",
  "profit_margins": 0.27,
  "total_revenue": 451442016256,
  "history_points": 20,
  "status": "success"
}

---

💼 Use Cases & Examples

1. Portfolio & Watchlist Tracking

Portfolio managers and individual investors monitoring a basket of holdings.

Input: A list of held tickers in Overview mode. Output: Live price, change %, market cap and 52-week range per holding. Use: Run on a schedule for a daily portfolio snapshot piped into a dashboard.

2. Market Screening

Quant researchers building thematic universes.

Input: A search query like "semiconductors" or "renewable energy". Output: Resolved tickers with full valuation metrics for each. Use: Build and rank candidate sets without hand-typing symbols.

3. Fundamental Research

Analysts evaluating companies before a deeper dive.

Input: Target tickers in Detail mode. Output: Sector, industry, employees, business summary, analyst target, recommendation, margins and revenue. Use: Assemble a one-page fundamentals brief per company in seconds.

4. Dividend & Valuation Analysis

Income investors comparing dividend stocks.

Input: A list of dividend candidates in Overview mode. Output: Dividend yield, P/E ratios, EPS and book value side by side. Use: Produce a ranked valuation table for portfolio rebalancing.

5. Fintech Dashboards & Pipelines

Fintech builders and agencies powering market widgets.

Input: Any ticker set, scheduled. Output: Clean JSON ready for BI tools and spreadsheets. Use: Feed automated market dashboards via N8N, Zapier or Make.

---

🔗 Integration Examples

JavaScript/Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/yahoo-finance-scraper').call({
  mode: 'overview',
  symbols: ['AAPL', 'MSFT', 'GOOGL']
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/yahoo-finance-scraper').call(
    run_input={'mode': 'detail', 'symbols': ['AAPL', 'MSFT']}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~yahoo-finance-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"mode": "overview", "query": "electric vehicle"}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule or webhook
2. HTTP Request: Call the actor API
3. Process: Handle JSON results
4. Action: Save, notify, or transform

---

📊 Performance & Pricing

FREE Tier (Try It Now)

• Up to 5 tickers per run — full feature access, same quality
• No credit card required
• Perfect for testing and small watchlists

PAID Tier (Production Ready)

• Unlimited tickers per run
• Fast batched lookups, no delays
• Pay-per-result: only charged for successful rows

💰 Best price on the market — cheap per-quote Overview pricing for high-volume screening, with a richer Detail tier only when you need fundamentals. Failed lookups are never billed.

🔗 View current pricing

---

❓ Frequently Asked Questions

Q: How many tickers can I process? A: FREE tier: 5 per run. PAID tier: unlimited (hundreds per run).

Q: What asset types are supported? A: Stocks, ETFs, indices, currency pairs and cryptocurrencies — anything with a Yahoo Finance ticker.

Q: What's the difference between Overview and Detail mode? A: Overview returns fast market data (price, valuation, volume). Detail adds full company profiles, analyst targets, financials and price-history coverage.

Q: What output formats are available? A: JSON, CSV and Excel — export directly from the Apify dataset.

Q: Am I charged for invalid or delisted tickers? A: No. Failed lookups produce a clear error row and are never billed.

Q: Is this legal? A: Yes — we only extract publicly available market data. See our legal section.

---

🐛 Troubleshooting

No data returned for a ticker

• Confirm the symbol matches Yahoo Finance exactly (e.g. ^GSPC for the S&P 500, BTC-USD for Bitcoin).
• Delisted or invalid tickers return an error row with an explanation.

Search returned no tickers

• Try a more specific company name or theme, or provide explicit tickers instead.

Only 5 results on a larger list

• That's the FREE-tier cap. Upgrade for unlimited tickers per run.

Missing fundamentals (sector, employees, etc.)

• Those fields are only populated in Detail mode. Switch mode to detail.

---

⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the legality of web scraping.

Trademark notice: Yahoo and Yahoo Finance are trademarks of their respective owners. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Yahoo. All financial data belongs to its respective owners and is provided for informational purposes only — not financial advice.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue in the actor's repository
• Check SIÁN Agency Store for more automation tools
• 📧 apify@sian-agency.online

---

Built by SIÁN Agency | More Tools