Google Finance API endpoint

Google Finance top headline

Returns the top Google Finance headline.

GETapiKey1 credit/requestfinance.headlineResponseDoc/google/finance/markets/headline

Parameters

Name	In	Type	Required	Enum	Example	Description
x-api-key	header	string	Yes			API key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 1 credit/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Failure responses

Status	Description	Schema
500	Internal Server Error	#/definitions/app.Response
502	Bad Gateway	#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "article": {
      "title": "The S&P 500 Just Hit a Record High. Is It Too Late to Buy?",
      "source": "TipRanks",
      "url": "https://www.tipranks.com/news/the-sp-500-just-hit-a-record-high-is-it-too-late-to-buy",
      "published_unix": 1777403286,
      "published_at": "2026-04-28T19:08:06Z",
      "thumbnail_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTsy2ZSFvZXrlIRo084m5icW9Ne...",
      "related": [
        {
          "ticker": ".INX",
          "exchange": "INDEXSP",
          "name": "S&P 500",
          "type": "index",
          "price": 7138.8,
          "change": -35.11035,
          "change_percent": -0.48941723,
          "identifier": ".INX:INDEXSP"
        }
      ]
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/finance.headlineResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	finance.HeadlineResponse	No
data.article	finance.FinanceArticle	No
data.article.published_at	string	No
data.article.published_unix	integer	No	1777077000
data.article.related	array	No
data.article.related[].after_hours	finance.PriceChange	No
data.article.related[].after_hours.change	number	No	-3.37
data.article.related[].after_hours.change_percent	number	No	-1.3
data.article.related[].after_hours.price	number	No	255.65
data.article.related[].change	number	No	-3.37
data.article.related[].change_percent	number	No	-1.3
data.article.related[].country	string	No	US
data.article.related[].currency	string	No	USD
data.article.related[].exchange	string	No	NASDAQ
data.article.related[].google_id	string	No	/m/07zmbvf
data.article.related[].identifier	string	No	AAPL:NASDAQ
data.article.related[].last_update_unix	integer	No	1777077000
data.article.related[].name	string	No	Apple Inc
data.article.related[].previous_close	number	No	236.35
data.article.related[].price	number	No	255.65
data.article.related[].ticker	string	No	AAPL
data.article.related[].timezone	string	No	America/New_York
data.article.related[].type	string	No	stock
data.article.source	string	No	Reuters
data.article.thumbnail_url	string	No
data.article.title	string	No	Apple announces an update
data.article.url	string	No	https://example.com/news
msg	string	No	OK

Example request

curl -X GET "https://api.crawlora.net/api/v1/google/finance/markets/headline" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/google/finance/markets/headline");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();

Open in Playground Back to group