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

# Google Finance top headline

`GET /google/finance/markets/headline`

## Request

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

Returns the top headline on Google Finance markets as one article: title, source, URL, publication time (ISO and Unix), thumbnail and the related instruments with price and change. The article is present only when Google Finance shows a headline.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- FinanceHeadlineResponseDoc
  - `code` integer
  - `data` FinanceHeadlineResponse
    - `article` FinanceFinanceArticle
      - `published_at` string: Time the article was published, in UTC (RFC 3339).
      - `published_unix` integer: Time the article was published, in Unix seconds.
      - `related` FinanceInstrument[]: Instruments mentioned in the article.
        - `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`.
      - `source` string: Name of the publisher of the article.
      - `thumbnail_url` string: URL of the article thumbnail image.
      - `title` string: Headline of the article.
      - `url` string: URL of the article on the publisher's site.
  - `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)