Yahoo Finance Scraper: 48 Data Fields, Up to 2,500 Free Results/Month

Each record carries 48 fields, including live price quotes, fundamental valuation metrics, historical OHLCV data, analyst recommendations, and news items across equities, ETFs, indices, and currencies. Results cost $2.00 per 1,000 items on Apify's free plan, which includes $5.00 of monthly prepaid usage covering up to 2,500 results without entering a credit card. Built for quantitative researchers, financial analysts, and algorithmic developers needing clean market structures. Not for traders requiring sub-second real-time order-book streaming, which this Actor does not output.

Try it: open Yahoo Finance Scraper on Apify, sign in on the free plan and run the prefilled example.

Can you try Yahoo Finance Scraper before paying?

Yes. Apify's free plan includes $5.00 of prepaid usage every month and asks for no credit card. At $0.002 per result, that covers up to 2,500 results of Yahoo Finance Scraper a month, before run-start charges and platform usage.

Yahoo Finance Scraper was last updated on 2026-04-30. It is one of 1,725 Actors CrawlerBros publishes on Apify, which together have 658,394 lifetime public runs and an average rating of 4.63 out of 5 across 416 reviews.

What does it cost to run Yahoo Finance Scraper?

Each result costs $0.002 on Apify's free plan, which is $2.00 per 1,000 results. Starting a run is charged separately at $0.005 per GB of Actor memory. Apify also bills the platform usage each run consumes, at the rates of your Apify plan, on top of these charges.

The tickers input array is the primary control affecting cost, as each valid ticker symbol generates one written result record. Enabling optional blocks like historical candles or financial balance sheets populates additional keys inside that single item without increasing the result count charge. To verify your setup cheaply, pass a small array of two or three tickers before running large watchlist sweeps.

How do you run Yahoo Finance Scraper from the API?

The schema marks 1 of its 19 controls as required: tickers. Nothing in the payload below is illustrative. Those are the schema's prefilled defaults for Yahoo Finance Scraper, so the request works once your token is in place.

Call the synchronous endpoint to start a run and receive dataset items in one request:

curl -X POST "https://api.apify.com/v2/acts/crawlerbros~yahoo-finance-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tickers":["AAPL","MSFT"]}'

The same run from Python, using the official client:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")

run_input = {
  "tickers": [
    "AAPL",
    "MSFT"
  ]
}

run = client.actor("crawlerbros~yahoo-finance-scraper").call(run_input=run_input)

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

And from Node.js:

import { ApifyClient } from 'apify-client'

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' })

const input = {
  "tickers": [
    "AAPL",
    "MSFT"
  ]
}

const run = await client.actor('crawlerbros~yahoo-finance-scraper').call(input)
const { items } = await client.dataset(run.defaultDatasetId).listItems()
console.log(items)

Because the call is synchronous, your client waits for the whole run. Keep it for exploration. For scheduled work, start the run without waiting and collect the dataset afterwards, so network trouble costs you a retry rather than the results.

Which Yahoo Finance Scraper inputs matter, and which can you skip?

The tickers array is the only required input control and specifies which assets to query across supported exchanges and formats. Controls like includeHistory, includeFinancials, and includeNews toggle specific nested sections on or off to tailor the output schema. Most users should keep default settings for initial testing and adjust interval or date parameters only when fetching specific historical candle ranges.

• tickers (array): One or more stock ticker symbols (e.g. AAPL, MSFT, BRK-B). Supports US, ETFs, ADRs, foreign tickers with suffix (e.g. BABA, TSM, BP.L).
• startDate (string): Earliest date for historical OHLCV data. Optional - default is 30 days before today.
• endDate (string): Latest date for historical OHLCV data. Optional - default is today.
• interval (string): Candle interval for historical data. Default: "1d".
• includeHistory (boolean): Include daily OHLCV history (open / high / low / close / volume) in each record. Default: true.
• includeFinancials (boolean): Include income statement, balance sheet, and cash flow statement (annual). Default: false.
• includeDividends (boolean): Include dividend history. Default: true.
• includeSplits (boolean): Include stock-split history. Default: true.
• includeNews (boolean): Include latest news headlines linked to the ticker. Default: true.
• includeRecommendations (boolean): Include analyst recommendation breakdown (strongBuy / buy / hold / sell / strongSell). Default: true.
• includeHolders (boolean): Include major / institutional / mutual-fund holder summaries. Default: false.
• includeOptions (boolean): Include the next-expiration options chain (calls + puts) when listed. Capped at first 50 strikes per side to keep dataset compact. Default: false.

The other 7 controls, with their defaults, are listed in the input schema on Yahoo Finance Scraper on Apify.

Fixed-choice controls: interval accepts 1d (1 day), 5d (5 days), 1wk (1 week), 1mo (1 month), 3mo (3 months).

What does Yahoo Finance Scraper return?

Output records supply rich financial datasets including price stats, market cap, valuation ratios, earnings calendar dates, and recent headlines ready for database ingestion or CSV exports. They do not contain real-time microsecond tick data or Level 2 order books. If Yahoo returns no data for a ticker, an error field is set instead of omitting the record entirely.

• ticker (e.g. AAPL)
• summaryUrl (e.g. https://finance.yahoo.com/quote/AAPL/)
• companyName (e.g. Apple Inc.)
• shortName (e.g. Apple)
• sector (e.g. Technology)
• industry (e.g. Consumer Electronics)
• country (e.g. United States)
• currency (e.g. USD)
• exchange (e.g. NMS)
• quoteType (e.g. EQUITY)
• website (e.g. https://www.apple.com)
• businessSummary
• fullTimeEmployees (e.g. 161000)
• marketCap (e.g. 3927938957312)
• currentPrice (e.g. 267.55)
• previousClose (e.g. 271.06)
• open (e.g. 269.5)
• dayHigh (e.g. 270)
• dayLow (e.g. 266.5)
• fiftyTwoWeekHigh (e.g. 280)
• fiftyTwoWeekLow (e.g. 175)
• volume (e.g. 50000000)
• averageVolume (e.g. 60000000)
• beta (e.g. 1.2)
• trailingPE (e.g. 30.5)
• forwardPE (e.g. 28)
• trailingEps (e.g. 7.2)
• dividendYield (e.g. 0.005)
• dividendRate (e.g. 1)
• dayChange (e.g. -3.51)
• dayChangePercent (e.g. -1.2949)
• history
• historyCount (e.g. 43)
• dividends
• dividendCount (e.g. 90)
• splits
• splitCount (e.g. 5)
• financials
• news
• newsCount (e.g. 10)
• recommendations
• calendar
• analystPriceTargets
• insiderTransactions
• insiderTransactionCount (e.g. 25)
• options
• optionExpirations
• scrapedAt (e.g. 2024-12-16T14:23:11+00:00)

These are the documented fields. Optional ones can be empty on a given record, so measure how often each field your deliverable depends on is populated across a real sample before automating the handoff.

How do you build the workflow end to end?

Open Yahoo Finance Scraper and work through these in order. Each step ends with something to check, so a bad configuration surfaces on a small run rather than a scheduled one.

1. Provide one or more stock symbols in the tickers array input, such as US equities, ETFs, or regional foreign tickers with appropriate suffixes.
2. Set the startDate and endDate text fields using YYYY-MM-DD formatting to bound your historical data fetch.
3. Select the candles aggregation window using the interval enum, choosing between daily, weekly, or monthly periods.
4. Toggle optional boolean flags like includeFinancials, includeNews, or includeHolders to define which data blocks to attach to each ticker.
5. Adjust the concurrency integer control to control how many tickers fetch simultaneously without triggering remote rate limits.
6. Execute a single test run and review the output dataset to ensure all expected data blocks exist without an error field.
7. Automate the run using Apify schedules or launch it via API once dataset field structure is validated.

How do you apply it? Three worked playbooks

These are Yahoo Finance Scraper's own documented use cases, each worked through as an operating pattern rather than a description.

Use case 1: Watchlist enrichment

Outcome: Pull live quote + fundamentals for every ticker in a watchlist on schedule.

Configure: Set tickers to ["AAPL", "MSFT", "GOOGL"], leave includeHistory as true, set includeFinancials to false, and set includeRecommendations to true.

Working method: Execute the run on a daily schedule post-market close, check that each ticker emits a complete record with currentPrice, and store the market metrics in your database.

Deliverable: A daily dataset containing live quotes, fundamental metrics, and analyst ratings for every targeted ticker symbol.

Stop condition: Stop execution if multiple records return an error field indicating bad ticker formats or network failures.

Use case 2: Backtesting / quant research

Outcome: Bulk OHLCV history with adjustable date range and interval.

Configure: Set tickers to ["SPY", "QQQ"], set startDate to "2023-01-01", set endDate to "2023-12-31", set interval to "1d", and set includeHistory to true.

Working method: Run the Actor across your target asset universe, inspect the history array length against expected trading days, and export the dataset directly into your historical backtesting pipeline.

Deliverable: A structured dataset of daily OHLCV historical candles with open, high, low, close, and volume metrics.

Stop condition: Stop execution if history arrays return empty or missing candle entries for active trading dates.

Use case 3: News monitoring

Outcome: Daily run pulls the latest 25 articles per ticker; downstream alerts on title keywords.

Configure: Set tickers to ["TSLA", "NVDA"], set includeNews to true, set includeHistory to false, and set concurrency to 4.

Working method: Schedule a daily run, pull the news array for each ticker record, and parse headline titles for target sentiment or event keywords.

Deliverable: A aggregate list of news items containing titles, publishers, publish timestamps, and story URLs.

Stop condition: Stop execution if news arrays stop populating or return empty lists across major equities.

What breaks, and how do you design around it?

When requesting broad historical ranges, ensure the startDate and endDate parameters align with valid calendar ranges to prevent empty candle outputs. Higher values for concurrency can speed up execution but might trigger temporary upstream rate limits from Yahoo Finance. If rate limits occur, lower the concurrency parameter to a conservative setting.

When should you not use Yahoo Finance Scraper?

Do not use this Actor if you require specialized A-share Chinese market feeds or dedicated local news coverage. For direct extraction from major Chinese financial portals, use East Money Scraper or Tonghuashun (同花顺) Finance Scraper. If your workflow only requires basic US equity OHLCV historical pricing without extended fundamental or analyst data, consider using US Stock Price Scraper instead.

What should you check before trusting the output?

• Verify the presence of an error field on output records to capture delisted or invalid ticker symbols without crashing pipelines.
• Confirm that marketCap contains a valid numeric value on equity tickers where valuation metrics are expected.
• Check that history is an array of objects containing valid daily close figures when includeHistory is set to true.
• Ensure news arrays contain headline titles and valid external URLs when news monitoring is enabled.
• Validate that financial statement objects contain expected date-keyed line items when includeFinancials is active.

None of this proves a record is correct. It gives a scheduled Yahoo Finance Scraper run defined points where it should stop instead of quietly passing bad data downstream.

Frequently asked questions

Does this Actor require proxy setup or API keys?

No API key or external proxy configuration is required. The Actor runs HTTP requests directly and uses automated crumb-cookie handling to manage access to Yahoo Finance endpoints.

How much does it cost to run 1,000 tickers?

On Apify's free plan, processing 1,000 results costs $2.00 at $0.002 per result, plus minor platform usage compute charges. Higher tier paid plans lower the per-result price further.

What happens when a ticker is invalid or delisted?

If Yahoo Finance returns no data for a symbol, the Actor generates a dataset item containing an error field and skips normal payload generation without crashing the run.

Can I extract data for foreign stock tickers?

Yes. Foreign stock symbols are supported by using Yahoo's regional suffixes, such as BP.L for London or 0700.HK for Hong Kong.

How often is the underlying pricing data updated?

Intraday price quotes and volume metrics reflect delayed market feeds, while news items arrive in real time and financial statements update following public company filings.

Where to go next

When you are ready to run it, open Yahoo Finance Scraper on Apify; the free plan covers up to 2,500 results a month.

Readers running Yahoo Finance Scraper commonly pair it with:

• US Stock Price Scraper: Download historical stock price data (OHLCV) for US stocks, ETFs, and indices from Yahoo Finance.
• Tonghuashun (同花顺) Finance Scraper: Scrape Tonghuashun (10jqka.com.cn) A-share stock quotes via the public realhead API, market news via the news feed API, and stock search.
• East Money Scraper: Scrape East Money (eastmoney.com) - China's largest finance portal.
• CA Cal-Access Campaign Finance Scraper: Search California campaign-finance filers on Cal-Access - committees, candidates, major donors, lobbyists, lobbying firms & employers.
• Yahoo News Scraper: Scrape Yahoo News articles across categories, trending stories, and keyword search.

Related guides:

• FEC Campaign Finance Data Scraper: $5.00 per 1,000 results (2026)

Resources

• Actor documentation, input schema, and pricing: verified against the published Actor on 2026-09-24.

• Actor last updated by its maintainers on 2026-04-30.

• Run outcome figures cover the 30 day public window ending 2026-09-24.

• Yahoo Finance Scraper on Apify