Yahoo Finance API endpoint
Returns Yahoo Finance calendar rows for the path `type`: `earnings`, `ipo`, `economic-events` or `splits`. Narrow with `start` and `end` (YYYY-MM-DD, RFC3339 or Unix seconds) and page with `limit` (max 100) and `offset`. For `earnings` only, `market_cap` sets a minimum and `filter_most_active` (default true) filters. The response echoes the window and paging with the `rows`.
/yahoo-finance/calendars/{type}Path parameters: type.
Query parameters: start, end, limit, offset, market_cap, filter_most_active.
Notable response behavior: Yahoo caps limit at 100. Earnings supports the optional market-cap and most-active filters.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| type (path) | string | Yes | Calendar type: earnings, ipo, economic-events, or splits Allowed values: earnings, ipo, economic-events, splits. | earnings | |
| start | string | No | Start date as YYYY-MM-DD, RFC3339, or Unix seconds | ||
| end | string | No | End date as YYYY-MM-DD, RFC3339, or Unix seconds | ||
| limit | integer | No | Result count, max 100 | ||
| offset | integer | No | Result offset | ||
| market_cap | number | No | Earnings-only market cap minimum | ||
| filter_most_active | boolean | No | Earnings-only most-active filter, default true | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/yahoo-finance/calendars/earnings?limit=10&filter_most_active=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"type": "earnings",
"limit": 5,
"offset": 0,
"rows": [
{
"Symbol": "AAPL",
"Company": "Apple Inc."
}
]
}
}Request schema
No body schema
Response schema
#/definitions/yahoofinance.calendarResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yahoofinance.CalendarResponse | No | ||||
| data.end | string | No | 2026-05-27 | Last date covered, as YYYY-MM-DD. | ||
| data.limit | integer | No | 12 | Maximum number of rows returned. | ||
| data.offset | integer | No | 0 | Zero-based offset of the first row. | ||
| data.rows | array | No | Calendar entries, one object per row, with the columns Yahoo Finance shows. | |||
| data.start | string | No | 2026-05-20 | First date covered, as YYYY-MM-DD. | ||
| data.type | string | No | earnings | Calendar returned, for example `earnings`. | ||
| 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/calendars/earnings?limit=10&filter_most_active=true" \
-H "x-api-key: $CRAWLORA_API_KEY"