Google Finance API endpoint

Google Finance category news

Returns normalized news for a Google Finance category.

GETapiKey1 credit/requestfinance.categoryNewsResponseDoc/google/finance/markets/categories/{category}/news

Parameters

Name	In	Type	Required	Description
category	path	string	Yes	Google Finance category id
offset	query	integer	No	Result offset
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

Catalog quality warnings

missing example for required path param: category

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
502	Bad Gateway	#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "category": "2",
    "items": [
      {
        "title": "Technology shares rise",
        "source": "Reuters"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/finance.categoryNewsResponseDoc

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

Example request

curl -X GET "https://api.crawlora.net/api/v1/google/finance/markets/categories/%3Ccategory%3E/news" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/google/finance/markets/categories/%3Ccategory%3E/news");
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