# Yahoo Finance Scraper data API: fields, sample output and cost per 1,000 rows

Scrape Yahoo Finance for stocks, ETFs, indexes, crypto and currencies: quotes and key statistics (price, market cap, P/E, dividend, earnings date), price history with adjusted close and dividends, or options chains with bid, ask, open interest, implied volatility, greeks and max pain.

This is the reference for the Actor `v0iddo/yahoo-finance-scraper`: what is in every output row, what the input takes, and what a run costs. Values below come from a real run of the Actor.

## At a glance

| | |
| --- | --- |
| Actor | `v0iddo/yahoo-finance-scraper` |
| Store page | [Yahoo Finance Scraper](https://apify.com/v0iddo/yahoo-finance-scraper) |
| Output | one row per result, as JSON, CSV, Excel or HTML |
| Fields per row | 33 (19 number, 12 text, 1 URL, 1 date) |
| Cap on results | `maxItems` in the input |
| Price | $0.50 per 1,000 results |

## Output fields

Each result is one row with these fields (fields that name people are left out):

| Field | Type | Meaning | Sample value |
| --- | --- | --- | --- |
| `symbol` | text | Symbol | AAPL |
| `name` | text | Name | Apple Inc. |
| `quoteType` | text | Type | EQUITY |
| `price` | number | Price | 347.725 |
| `currency` | text | Currency | USD |
| `changePercent` | number | Change % | -0.14215012 |
| `volume` | number | Volume | 39539690 |
| `marketCap` | number | Market cap | 5074761285632 |
| `trailingPE` | number | P/E | 39.87672 |
| `dividendYield` | number | Dividend yield % | 0.31 |
| `fiftyTwoWeekLow` | number | 52 week low | 243.42 |
| `fiftyTwoWeekHigh` | number | 52 week high | 351.73 |
| `regularMarketTime` | date | Quote time | 2026-10-23T20:00:01Z |
| `url` | URL | Yahoo Finance page | https://finance.yahoo.com/quote/AAPL/ |
| `exchange` | text |  | NasdaqGS |
| `marketState` | text |  | OVERNIGHT |
| `change` | number |  | -0.49499512 |
| `previousClose` | number |  | 348.22 |
| `open` | number |  | 349.11 |
| `dayLow` | number |  | 345.75 |
| `dayHigh` | number |  | 351.73 |
| `averageVolume` | number |  | 43991589 |
| `forwardPE` | number |  | 36.365494 |
| `epsTrailing` | number |  | 8.72 |
| `dividendRate` | number |  | 1.08 |
| `exDividendDate` | text |  | 2026-08-10 |
| `beta` | number |  | 1.069 |
| `earningsDate` | text |  | 2026-11-02 |
| `targetMeanPrice` | number |  | 329.24768 |
| `recommendation` | text |  | buy |
| `sector` | text |  | Technology |
| `industry` | text |  | Consumer Electronics |
| `scrapedAt` | text |  | 2026-10-26T04:30:36Z |

## One record

```json
{
  "symbol": "AAPL",
  "name": "Apple Inc.",
  "quoteType": "EQUITY",
  "exchange": "NasdaqGS",
  "currency": "USD",
  "marketState": "OVERNIGHT",
  "price": 347.725,
  "change": -0.49499512,
  "changePercent": -0.14215012,
  "previousClose": 348.22,
  "open": 349.11,
  "dayLow": 345.75,
  "dayHigh": 351.73,
  "fiftyTwoWeekLow": 243.42,
  "fiftyTwoWeekHigh": 351.73,
  "volume": 39539690,
  "averageVolume": 43991589,
  "marketCap": 5074761285632,
  "trailingPE": 39.87672,
  "forwardPE": 36.365494,
  "epsTrailing": 8.72,
  "dividendRate": 1.08,
  "dividendYield": 0.31,
  "exDividendDate": "2026-08-10",
  "beta": 1.069,
  "earningsDate": "2026-11-02",
  "targetMeanPrice": 329.24768,
  "recommendation": "buy",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "regularMarketTime": "2026-10-23T20:00:01Z",
  "url": "https://finance.yahoo.com/quote/AAPL/",
  "scrapedAt": "2026-10-26T04:30:36Z"
}
```

## Input parameters

| Parameter | Type | Required | Default | What it does |
| --- | --- | --- | --- | --- |
| `tickers` | array | yes | ["AAPL", "MSFT", "NVDA", "AMZN", "GOOGL", "META", "TSLA", "SPY", "Q... | Yahoo Finance symbols, one per entry: stocks such as AAPL or BRK-B, ETFs such as SPY, indexes such as ^GSPC, crypto such as BTC-USD, currency pairs such as EURUSD=X an... |
| `dataType` | string | no | quotes | quotes: one row per ticker with price, change, volume and key statistics. |
| `startDate` | string | no |  | First day of the price history as YYYY-MM-DD, for example 2020-01-01. |
| `endDate` | string | no |  | Last day of the price history as YYYY-MM-DD. |
| `interval` | string | no | 1d | One row per trading day, week or month. |
| `optionType` | string | no | all | Which contracts to return. |
| `expirations` | integer | no | 1 | How many expiration dates to read per ticker, starting from the nearest one. |
| `expirationDates` | array | no |  | Read these expiration dates instead of the nearest ones, as YYYY-MM-DD, for example 2026-12-18. |
| `minStrike` | integer | no |  | Skip contracts with a lower strike price. |
| `maxStrike` | integer | no |  | Skip contracts with a higher strike price. |
| `minOpenInterest` | integer | no |  | Skip contracts with less open interest. |
| `minVolume` | integer | no |  | Skip contracts that traded fewer contracts today. |
| `riskFreeRate` | number | no |  | Yearly interest rate in percent, such as a Treasury bill yield, used for the greeks, for example 4.25. |
| `maxItems` | integer | no | 100 | The run stops after this many result rows. |

## Ready-made examples

Saved inputs on Apify: run one as it is, or copy it and change the values.

- [Yahoo Finance quotes for big tech, indexes, BTC and EUR/USD](https://apify.com/v0iddo/yahoo-finance-scraper/examples/yahoo-finance-big-tech-quotes)
- [Yahoo Finance quotes for 12 dividend stocks](https://apify.com/v0iddo/yahoo-finance-scraper/examples/yahoo-finance-dividend-stock-quotes)
- [Yahoo Finance futures quotes: oil, gold, gas, grains, indexes](https://apify.com/v0iddo/yahoo-finance-scraper/examples/yahoo-finance-commodity-futures-quotes)

## Cost per 1,000 rows

$0.50 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $0.35 per 1,000.

| Results | Cost at the listed price | Cost at the lowest plan price |
| --- | --- | --- |
| 100 | $0.05 | $0.04 |
| 1,000 | $0.50 | $0.35 |
| 10,000 | $5.00 | $3.50 |
| 100,000 | $50.00 | $35.00 |

The figures are the listed price times the number of results. The `maxItems` limit and the maximum cost setting in the run options both stop a run before it spends more than you planned.

## Get the rows as CSV over HTTP

One request starts a run, waits for it and returns the dataset. The `format` parameter picks the file type and `fields` picks the columns. Replace the token with the one from Apify Console, Settings, Integrations.

```bash
curl -X POST "https://api.apify.com/v2/acts/v0iddo~yahoo-finance-scraper/run-sync-get-dataset-items?format=csv&fields=symbol,name,quoteType" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tickers": ["AAPL", "MSFT", "NVDA", "AMZN", "GOOGL", "META", "TSLA", "SPY", "QQQ", "^GSPC", "BTC-USD", "EURUSD=X"], "maxItems": 20}'
```

## Good to know

- One row per ticker, read from the public quote page finance.yahoo.com/quote/TICKER/. That page already carries the quote and the key statistics, so the run makes one request per ticker.
- changePercent and dividendYield are percentages: 0.43 means 0.43 percent. Dates are ISO 8601: exDividendDate and earningsDate as YYYY-MM-DD, regularMarketTime and scrapedAt in UTC.

## Links

- Actor on the Apify Store: [Yahoo Finance Scraper](https://apify.com/v0iddo/yahoo-finance-scraper)
- Guide with the Python and JavaScript code: [https://voidd0.github.io/yahoo-finance-scraper/](https://voidd0.github.io/yahoo-finance-scraper/)
- Step by step: [https://voiddo.com/export/yahoo-finance-scraper/](https://voiddo.com/export/yahoo-finance-scraper/)