Yahoo Finance API endpoint
Returns historical prices for up to 25 symbols in one POST. The body requires `symbols`; `period`, `start`, `end`, `interval`, `include_prepost` and `include_actions` are optional. Each result is one symbol, with price points (open, high, low, close, adjusted close, volume) and dividend, split and capital-gain events, or an `error` for that symbol.
/yahoo-finance/downloadJSON body: symbols is required. Optional fields are period, start, end, interval, include_prepost, and include_actions.
| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| symbol | 2 | “AAPL” and 1 other value |
| history | 2 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| request (body) | object | Yes | Batch download request | ||
| x-api-key (header) | string | Yes | API key required |
curl -X POST "https://api.crawlora.net/api/v1/yahoo-finance/download" \
-H "x-api-key: $CRAWLORA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"auto_adjust":true,"back_adjust":true,"end":"string","include_actions":true,"include_prepost":true,"interval":"string","keepna":true,"period":"string","rounding":true,"start":"string","symbols":["string"]}'{
"auto_adjust": true,
"back_adjust": true,
"end": "string",
"include_actions": true,
"include_prepost": true,
"interval": "string",
"keepna": true,
"period": "string",
"rounding": true,
"start": "string",
"symbols": [
"string"
]
}{
"code": 200,
"msg": "OK",
"data": {
"results": [
{
"symbol": "AAPL",
"history": {
"symbol": "AAPL",
"points": []
}
}
]
}
}Request schema
#/definitions/yahoofinance.DownloadRequest
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| auto_adjust | boolean | No | ||||
| back_adjust | boolean | No | ||||
| end | string | No | ||||
| include_actions | boolean | No | ||||
| include_prepost | boolean | No | ||||
| interval | string | No | ||||
| keepna | boolean | No | ||||
| period | string | No | ||||
| rounding | boolean | No | ||||
| start | string | No | ||||
| symbols | array | Yes |
Response schema
#/definitions/yahoofinance.downloadResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yahoofinance.DownloadResponse | No | ||||
| data.results | array | No | One result per requested symbol, in request order. | |||
| data.results[].error | string | No | Message explaining why the history could not be returned. Omitted on success. | |||
| data.results[].history | object | No | Price history of the symbol. Omitted when the symbol failed. | |||
| data.results[].history.events | object | No | Dividends, splits and capital gains in the period. Present when actions were requested. | |||
| data.results[].history.events.capital_gains | array | No | Capital gain distributions in the period. | |||
| data.results[].history.events.dividends | array | No | Dividend payments in the period. | |||
| data.results[].history.events.splits | array | No | Stock splits in the period. | |||
| data.results[].history.meta | object | No | Metadata about the instrument and the price series, as Yahoo Finance reports it. | |||
| data.results[].history.points | array | No | Price candles in time order. | |||
| data.results[].history.points[].adj_close | number | No | 211 | Closing price adjusted for dividends and splits. | ||
| data.results[].history.points[].close | number | No | 211 | Closing price of the candle. | ||
| data.results[].history.points[].datetime | string | No | 2026-05-18T13:30:00Z | Start of the candle, in UTC (RFC 3339). | ||
| data.results[].history.points[].high | number | No | 212 | Highest price of the candle. | ||
| data.results[].history.points[].low | number | No | 209 | Lowest price of the candle. | ||
| data.results[].history.points[].open | number | No | 210 | Opening price of the candle. | ||
| data.results[].history.points[].timestamp | integer | No | 1779111000 | Start of the candle, in Unix seconds. | ||
| data.results[].history.points[].volume | integer | No | 54200000 | Number of shares traded during the candle. | ||
| data.results[].history.symbol | string | No | AAPL | Ticker symbol, for example `AAPL`. | ||
| data.results[].symbol | string | No | Ticker symbol this result is for. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X POST "https://api.crawlora.net/api/v1/yahoo-finance/download" \
-H "x-api-key: $CRAWLORA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"auto_adjust":true,"back_adjust":true,"end":"string","include_actions":true,"include_prepost":true,"interval":"string","keepna":true,"period":"string","rounding":true,"start":"string","symbols":["string"]}'