# Yahoo Finance Scraper — Structured Stock & Financial Data

> Yahoo Finance Scraper — Structured Stock & Financial Data is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Fetches structured financial data for one or more stock tickers from Yahoo Finance, including price history, financials, news, holders, and options.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/yahoo-finance?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yahoo-finance-scraper-structured-stock-financial-data-def7462d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BZcz1kejQvwO-bvKZnrID

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability yahoo-finance-scraper-structured-stock-financial-data-def7462d -d '<json body>'
```

Example prompt: Pull Yahoo Finance data for AAPL, MSFT, and NVDA — I want daily price history from 2024-01-01 to 2024-12-31, their income statements and balance sheets, and the 10 most recent news headlines for each.

## When to prefer this

Choose this endpoint when you need structured, multi-dimensional Yahoo Finance data for one or more tickers in a single call — especially when you want to combine price history, financials, news, and holders without stitching together multiple APIs. It is pay-per-call with no charge on failed or empty runs, making it safe for exploratory queries. Prefer it over general web scraping when Yahoo Finance is the authoritative source you need.

## Known failure modes

- Invalid or delisted ticker symbol returns empty item or null fields
- Date range with no trading days (e.g. holidays only) returns empty price history
- Yahoo Finance rate limiting or anti-scraping measures may cause failed runs (not charged)
- Malformed date format (not YYYY-MM-DD) may cause errors
- maxItems=0 with a large ticker list may take longer and time out

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count and an array of items, one per ticker. Each item includes ticker symbol, company name, sector, industry, exchange, currency, quote type, and quote URL, plus optional arrays for daily price history, financial statements (income, balance sheet, cash flow), recent news headlines, institutional/fund holders, and nearest-expiry options (calls and puts).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tickers": {
   "type": "array",
   "description": "Yahoo Finance ticker symbols. Each symbol produces one dataset item."
  },
  "end_date": {
   "type": "string",
   "description": "Last calendar date to include in daily price history (YYYY-MM-DD), inclusive. Defaults to today."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Stop after this many ticker records across the run. Zero means all supplied tickers."
  },
  "start_date": {
   "type": "string",
   "description": "First calendar date to include in daily price history (YYYY-MM-DD). Defaults to one year ago."
  },
  "includeNews": {
   "type": "boolean",
   "default": true,
   "description": "Fetch recent ticker headlines from the public finance news feed."
  },
  "includeHolders": {
   "type": "boolean",
   "default": false,
   "description": "Fetch public institutional and fund holdings plus ownership summary."
  },
  "includeOptions": {
   "type": "boolean",
   "default": false,
   "description": "Fetch expiration dates and calls and puts for the nearest expiry."
  },
  "maxNewsPerTicker": {
   "type": "integer",
   "default": 10,
   "maximum": 50,
   "minimum": 0,
   "description": "Maximum recent news items saved for each ticker."
  },
  "includeFinancials": {
   "type": "boolean",
   "default": true,
   "description": "Fetch annual and quarterly income, balance sheet, and cash flow summaries."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "name": null,
    "sector": null,
    "ticker": null,
    "currency": null,
    "exchange": null,
    "industry": null,
    "quoteUrl": null,
    "quoteType": null
   }
  ],
  "product": "yahoo-finance"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yahoo-finance-scraper-structured-stock-financial-data-def7462d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)