Yahoo Finance API endpoint
Returns the symbols Yahoo Finance lists as trending in a `region` such as `US`. `count` sets how many. The response has `region`, `count`, the `symbols`, and the `job_timestamp` and `start_interval` fields.
/yahoo-finance/trending/{region}Path parameters: region.
Query parameters: optional count.
| Field | In the sample | Value in the sample |
|---|---|---|
| region | Has a value | “US” |
| count | Has a value | 20 |
| symbols | Has a value | 20 entries |
| job_timestamp | Has a value | 2026-10-13 |
| start_interval | Has a value | 202,610,131,600 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| region (path) | string | Yes | Region such as US | US | |
| count | integer | No | Symbol count | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/yahoo-finance/trending/US?count=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"region": "US",
"count": 5,
"symbols": [
"NVDA",
"BTC-USD"
]
}
}Request schema
No body schema
Response schema
#/definitions/yahoofinance.trendingResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yahoofinance.TrendingResponse | No | ||||
| data.count | integer | No | 5 | Number of trending symbols returned. | ||
| data.job_timestamp | integer | No | 1779268508061 | Time Yahoo Finance generated the list, in Unix milliseconds. | ||
| data.region | string | No | US | Region code of the trending list, for example `US`. | ||
| data.start_interval | integer | No | 202605200800 | Start of the trending interval, as a 12-digit number such as `202605200800`. | ||
| data.symbols | array | No | Trending ticker symbols. | |||
| 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 GET "https://api.crawlora.net/api/v1/yahoo-finance/trending/US?count=10" \
-H "x-api-key: $CRAWLORA_API_KEY"