---
title: "Google Finance earnings calendar"
method: GET
path: "/google/finance/markets/earnings"
tags: ["Google"]
---

# Google Finance earnings calendar

`GET /google/finance/markets/earnings`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/google/finance/markets/earnings`
- Auth: API key in header `x-api-key`

Returns the Google Finance earnings calendar. Each item has the company name, fiscal period, event time (including a Unix timestamp), conference call phone and URL when listed, and the instrument with its ticker, exchange, price and change.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- FinanceEarningsResponseDoc
  - `code` integer
  - `data` FinanceEarningsCalendarResponse
    - `items` FinanceEarningsEvent[]: Upcoming earnings events from the Google Finance earnings calendar.
      - `company_name` string: Name of the company reporting earnings.
      - `conference_phone` string: Phone number for the earnings call.
      - `conference_url` string: URL of the earnings call.
      - `event_time` string: Time of the earnings event, in UTC (RFC 3339).
      - `event_unix` integer: Time of the earnings event, in Unix seconds.
      - `fiscal_period` string: Fiscal period the earnings report covers.
      - `instrument` FinanceInstrument
        - `after_hours` FinancePriceChange
          - `change` number: Price change, in the same unit as `price`.
          - `change_percent` number: Price change as a percentage.
          - `price` number: Price in after-hours trading.
        - `change` number: Price change shown by Google Finance, in the same unit as `price`.
        - `change_percent` number: Price change as a percentage, as Google Finance shows it.
        - `country` string: Country code of the instrument, for example `US`.
        - `currency` string: Currency code the instrument is priced in, for example `USD`.
        - `exchange` string: Exchange the instrument trades on, for example `NASDAQ`.
        - `google_id` string: Google's id for the instrument, for example `/m/07zmbvf`.
        - `identifier` string: Instrument identifier in `TICKER:EXCHANGE` form, for example `AAPL:NASDAQ`. Use it as the `quote` path parameter.
        - `last_update_unix` integer: Time of the latest price update, in Unix seconds.
        - `name` string: Instrument name, for example `Apple Inc`.
        - `previous_close` number: Closing price of the previous trading day.
        - `price` number: Latest price of the instrument.
        - `ticker` string: Ticker symbol of the instrument.
        - `timezone` string: IANA time zone of the instrument's market, for example `America/New_York`.
        - `type` string: Kind of instrument: `stock`, `index`, `crypto`, `etf` or `other`.
  - `msg` string

## Other responses

- `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/afac9b012a27?raw)