# Yahoo Finance Scraper — Stock Quotes, History & Fundamentals (`highbrow_fame/yahoo-finance-quotes`) Actor

Yahoo Finance quotes for stocks, ETFs, crypto, currencies and indexes: price, change, volume, P/E, market cap, dividends. Price history and company fundamentals on request.

- **URL**: https://apify.com/highbrow\_fame/yahoo-finance-quotes.md
- **Developed by:** [yestrue](https://apify.com/highbrow_fame) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 symbol delivereds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Yahoo Finance Scraper — Stock Quotes, History & Fundamentals

Get Yahoo Finance data for any symbol — stocks on any exchange, ETFs, crypto, currencies, futures and indexes: price, change, volume, market cap, P/E, EPS, dividends, 52-week range and more. Switch on price history for daily, weekly or intraday prices with dividends and splits, and company data for sector, revenue, margins, cash, debt and analyst targets.

**Why this one**

- ⚡ **Fast.** Quotes come 50 symbols to a request. A live test run of 12 symbols — with company data and five years of weekly prices each — took 3.3 seconds.
- 🌍 **Every market Yahoo covers.** Tested on US, UK (VOD.L), German (SAP.DE) and Japanese (7203.T) stocks, an ETF, Bitcoin and Ether, EUR/USD, the S\&P 500 and gold futures.
- 📈 **History with corporate actions.** Open, high, low, close, adjusted close and volume, plus dividends and splits, for any period and interval.
- 🏢 **Company data, not noise.** Sector, industry, employees, business summary, revenue, margins, cash, debt, returns and analyst targets — only for companies; crypto, currencies and indexes say so instead of returning empty fields.
- 💸 **You pay only per symbol delivered.** Unknown symbols come back as free records with the reason.

### What you get

For every symbol:

| Field | What it is |
|---|---|
| `symbol`, `name`, `quoteType`, `exchange`, `currency`, `marketState` | what it is and where it trades |
| `price`, `change`, `changePercent`, `previousClose`, `open`, `dayLow`, `dayHigh`, `volume`, `bid`, `ask`, `marketTime` | the quote |
| `fiftyTwoWeekLow`, `fiftyTwoWeekHigh`, `fiftyDayAverage`, `twoHundredDayAverage`, `averageVolume3Month` | ranges and averages |
| `marketCap`, `sharesOutstanding`, `trailingPE`, `forwardPE`, `epsTrailingTwelveMonths`, `epsForward`, `priceToBook`, `bookValue` | valuation |
| `dividendRate`, `dividendYield`, `dividendDate`, `earningsDate`, `analystRating` | dividends, earnings, analysts |
| `profile`, `financials`, `keyStatistics` | with **Company data** on: sector, industry, website, city, country, employees, summary; revenue, growth, margins, EBITDA, cash, debt, free cash flow, ROE, analyst targets and recommendation; enterprise value, beta, PEG, holdings, short interest |
| `history` | with **Price history** on: `points` (date, open, high, low, close, adjClose, volume), `dividends`, `splits` |
| `input`, `scrapedAt`, `status`, `error` | what you typed, when it was read, and why a symbol gave nothing |

#### Example

A real record from a live run, 24 September 2026 (shortened: one history point and one dividend shown):

```json
{
  "symbol": "AAPL",
  "name": "Apple Inc.",
  "quoteType": "EQUITY",
  "exchange": "NasdaqGS",
  "currency": "USD",
  "price": 336.075,
  "changePercent": -0.28039193,
  "volume": 7608141,
  "marketCap": 4904739405824,
  "trailingPE": 38.496567,
  "dividendYield": 0.32,
  "marketTime": "2026-09-24T15:28:39.000Z",
  "profile": { "sector": "Technology", "industry": "Consumer Electronics", "employees": 150000 },
  "financials": { "totalRevenue": 466822987776, "profitMargins": 0.27618998, "targetMeanPrice": 328.22205, "recommendation": "buy" },
  "history": {
    "interval": "1wk",
    "points": [{ "date": "2026-09-24T15:28:39.000Z", "open": 336.32, "high": 338.26, "low": 334.3, "close": 336.075, "adjClose": 336.075, "volume": 7608144 }],
    "dividends": [{ "date": "2026-08-10T13:30:00.000Z", "amount": 0.27 }]
  },
  "status": "OK"
}
```

### How to use it

1. Add **Symbols**, one per line, as Yahoo Finance writes them: `AAPL`, `VOD.L`, `SAP.DE`, `7203.T`, `SPY`, `BTC-USD`, `EURUSD=X`, `GC=F`, `^GSPC`.
2. Switch on **Company data** and/or **Price history**, and pick the period and interval.
3. Press **Start**, and download the results from the **Output** tab as JSON, CSV or Excel.

For a daily watchlist, save your input as a task and schedule it after the market closes.

You can also call it from the Apify API, from Make, Zapier or n8n, or from an AI agent through the Apify MCP server.

### Pricing

You are charged **per symbol delivered** — see the price on this page — whether or not you add company data and history. Unknown symbols are free.

### FAQ

**Are the prices real-time?** They are what Yahoo Finance shows: real-time for many US stocks and crypto, delayed for some exchanges — `exchangeDelayMinutes` says by how much.

**Why no company data for Bitcoin or the S\&P 500?** They are not companies. The record says so in `fundamentalsUnavailable`.

**Is this affiliated with Yahoo?** No. This is an independent tool that reads public Yahoo Finance data. It is not investment advice.

**Like it?** A short review on the Store page helps other people find this Actor. Something missing or broken? Tell us on the Issues tab — we read every one.

# Actor input Schema

## `symbols` (type: `array`):

Yahoo Finance symbols, one per line: stocks (AAPL, VOD.L, SAP.DE), ETFs (SPY), crypto (BTC-USD), currencies (EURUSD=X), indexes (^GSPC).

## `includeFundamentals` (type: `boolean`):

Add sector, industry, website, employees, business summary, revenue, margins, cash, debt, analyst targets and key statistics (one extra request per symbol).

## `includeHistory` (type: `boolean`):

Add open, high, low, close, adjusted close and volume for the period below, with dividends and splits.

## `historyRange` (type: `string`):

How far back. Ignored when you set dates below.

## `historyInterval` (type: `string`):

One point per minute, hour, day, week or month. Minute intervals work for recent days only.

## `historyFrom` (type: `string`):

Optional, YYYY-MM-DD.

## `historyTo` (type: `string`):

Optional, YYYY-MM-DD. Defaults to today.

## `maxConcurrency` (type: `integer`):

How many symbols to work on at the same time.

## `proxyConfiguration` (type: `object`):

Used only when Yahoo turns a request down: the first try goes out directly.

## Actor input object example

```json
{
  "symbols": [
    "AAPL",
    "MSFT",
    "BTC-USD"
  ],
  "includeFundamentals": false,
  "includeHistory": false,
  "historyRange": "1y",
  "historyInterval": "1d",
  "maxConcurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Every result as a JSON record, with a status for each input.

## `resultsCsv` (type: `string`):

The same records as CSV, for a spreadsheet.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "symbols": [
        "AAPL",
        "MSFT",
        "BTC-USD"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("highbrow_fame/yahoo-finance-quotes").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "symbols": [
        "AAPL",
        "MSFT",
        "BTC-USD",
    ],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("highbrow_fame/yahoo-finance-quotes").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "symbols": [
    "AAPL",
    "MSFT",
    "BTC-USD"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call highbrow_fame/yahoo-finance-quotes --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,highbrow_fame/yahoo-finance-quotes"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/97y3BADXXgSEdeX7p/builds/sNGptPcNfADlGJaww/openapi.json