Google Finance API endpoint
Searches Google Finance for instruments matching `q`, such as a company name. Each match has its ticker, exchange, company name, currency, price, change and percentage change.
/google/finance/searchQuery parameters:
q: required search keywordReturns Google Finance search matches as a wrapped array.
| Field | Filled in, of 5 checked | Values in the sample |
|---|---|---|
| ticker | 5 | “AAPL” and 4 other values |
| exchange | 5 | NYSE (3), NASDAQ (2) |
| company_name | 5 | “Apple Inc” and 4 other values |
| currency | 5 | USD in all 5 |
| price | 5 | 53.92 to 546.05, median 344.17 |
| change | 5 | -0.66 to 5.42, median 3.2 |
| percentage | 5 | -1.21 to 3.94, median 0.91 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Keyword to search for (e.g., Apple) | Apple | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/google/finance/search?q=Apple" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": [
{
"ticker": "AAPL",
"exchange": "NASDAQ",
"company_name": "Apple Inc",
"currency": "USD",
"price": 271.06
}
]
}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 |
| Status | Description | Schema |
|---|---|---|
| 400 | Invalid input parameters | #/definitions/app.Response |
| 500 | Internal server error | #/definitions/app.Response |
| 503 | Google Finance upstream request failed | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/google/finance/search?q=Apple" \
-H "x-api-key: $CRAWLORA_API_KEY"