Google Finance API endpoint
Google Finance Search API
Fetches normalized search results for a provided keyword from Google Finance.
GETapiKey1 credit/requestfinance.searchResponseDoc
/google/finance/searchParameters
| Name | In | Type | Required | Enum | Example | Description |
|---|---|---|---|---|---|---|
| q | query | string | Yes | Keyword to search for (e.g., Apple) | ||
| 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 query param: q
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Invalid input parameters | #/definitions/app.Response |
| 500 | Internal server error | #/definitions/app.Response |
| 502 | Google Finance upstream request failed | #/definitions/app.Response |
Request schema
No body schema
Response schema
#/definitions/finance.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | array | No | ||||
| data[].change | number | No | -3.369995 | The absolute change in the stock price compared to the previous close. | ||
| data[].company_name | string | No | Apple Inc | The name of the company associated with the stock ticker. | ||
| data[].currency | string | No | USD | The currency in which the stock price is denominated. | ||
| data[].exchange | string | No | NASDAQ | The stock exchange where the stock is listed. | ||
| data[].percentage | number | No | -1.301056 | The percentage change in the stock price compared to the previous close. | ||
| data[].price | number | No | 255.65 | The current price of the stock. | ||
| data[].ticker | string | No | AAPL | The stock ticker symbol. | ||
| msg | string | No | OK |
Example request
curl -X GET "https://api.crawlora.net/api/v1/google/finance/search" -H "x-api-key: <api-key>"
TypeScript fetch
const url = new URL("https://api.crawlora.net/api/v1/google/finance/search");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
method: "GET",
headers,
});
const payload = await response.json();