---
title: "Yahoo Finance earnings dates"
method: GET
path: "/yahoo-finance/ticker/{symbol}/earnings-dates"
tags: ["Yahoo Finance"]
---

# Yahoo Finance earnings dates

`GET /yahoo-finance/ticker/{symbol}/earnings-dates`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/yahoo-finance/ticker/{symbol}/earnings-dates`
- Auth: API key in header `x-api-key`

Returns earnings-date rows for a Yahoo Finance `symbol`, taken from Yahoo's earnings calendar table. `limit` (max 100) and `offset` page the rows. Each row is keyed by the table's column names, such as `Earnings Date`. Returns an upstream error when Yahoo does not serve the table.

## Path parameters

- `symbol` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- YahoofinanceEarningsDatesResponseDoc
  - `code` integer
  - `data` YahoofinanceEarningsDatesResponse
    - `limit` integer: Maximum number of rows returned.
    - `offset` integer: Zero-based offset of the first row.
    - `rows` object[]: Earnings dates, one object per row.
    - `symbol` string: Ticker symbol, for example `AAPL`.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)