Google Finance API endpoint
Returns Google Finance company details for a quote such as `AAPL:NASDAQ`: description, CEO, employee count, headquarters, sector, market capitalisation, P/E ratio, open, day high and low, 52-week high and low, and volume.
/google/finance/company/{quote}Path parameters:
quote: quote identifier such as AAPL:NASDAQReturns company information.
| Field | In the sample | Value in the sample |
|---|---|---|
| description | Has a value | 1,056 characters |
| headquarters | Has a value | “Cupertino, California, United States, US, One Apple Park Way” |
| ceo | Has a value | “John Ternus” |
| employees | Has a value | 166,000 |
| market_cap | Has a value | 5,013,538,637,584.84 |
| open | Has a value | 344.67 |
| high | Has a value | 348.15 |
| low | Has a value | 341.12 |
| fifty_two_week_high | Has a value | 348.15 |
| fifty_two_week_low | Has a value | 243.42 |
| pe_ratio | Has a value | 39.38 |
| volume | Has a value | 40,274,718 |
| sector | Has a value | “Computers, Peripherals, and Software” |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| quote (path) | string | Yes | Quote identifier such as AAPL:NASDAQ | AAPL:NASDAQ | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/google/finance/company/AAPL%3ANASDAQ" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories.",
"ceo": "Tim Cook",
"employees": 166000
}
}Request schema
No body schema
Response schema
#/definitions/finance.companyResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | finance.CompanyInfo | No | ||||
| data.ceo | string | No | Tim Cook | Name of the company's chief executive. | ||
| data.description | string | No | Company description shown on Google Finance. | |||
| data.employees | integer | No | 166000 | Number of employees. | ||
| data.fifty_two_week_high | number | No | 288.61 | Highest price over the last 52 weeks. | ||
| data.fifty_two_week_low | number | No | 169.21 | Lowest price over the last 52 weeks. | ||
| data.headquarters | string | No | Cupertino, CA, US | Location of the company's headquarters, for example `Cupertino, CA, US`. | ||
| data.high | number | No | 272.4 | Highest price of the trading day. | ||
| data.low | number | No | 269.1 | Lowest price of the trading day. | ||
| data.market_cap | number | No | 4010000000000 | Market capitalisation of the company, as a plain number. | ||
| data.open | number | No | 270.9 | Opening price of the trading day. | ||
| data.pe_ratio | number | No | 34.56 | Price-to-earnings ratio of the stock. | ||
| data.sector | string | No | Technology | Sector the company belongs to, for example `Technology`. | ||
| data.volume | integer | No | 41339643 | Number of shares traded, as Google Finance shows it. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/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/company/AAPL%3ANASDAQ" \
-H "x-api-key: $CRAWLORA_API_KEY"