Google Finance API endpoint
Returns the financial statements Google Finance holds for a quote such as `AAPL:NASDAQ`, as `annual` and `quarterly` rows plus a `currency`. Each row has revenue, net income, EBITDA, EPS, margins, cash flow, assets, liabilities and equity. The rows are empty when Google Finance has no statement data for the quote.
/google/finance/financials/{quote}Path parameters:
quote: quote identifier such as AAPL:NASDAQ| Field | Filled in, of 28 checked | Values in the sample |
|---|---|---|
| period_end | 28 | 2016-09-24 to 2026-06-27 |
| period | 28 | quarterly in all 28 |
| revenue | 28 | 94,036,000,000 to 416,161,000,000, median 260,174,000,000 |
| net_income | 28 | 14,736,000,000 to 112,010,000,000, median 55,256,000,000 |
| eps | 28 | 0.96 to 7.46, median 2.97 |
| operating_margin | 28 | 15.52 to 27.23, median 23.97 |
| operating_income | 28 | 28,202,000,000 to 133,050,000,000, median 63,930,000,000 |
| ebitda | 28 | 50,318,000,000 to 223,546,000,000, median 161,782,000,000 |
| shares_outstanding | 28 | 89,162,375,340 to 415,655,411,720, median 259,153,349,330 |
| eps_diluted | 28 | 1.57 to 7.46, median 2.97 |
| revenue_growth_yoy | 28 | 0 to 0.05, median 0 |
| pe_ratio | 28 | 16.49 to 48.51, median 38.7 |
| total_assets | 28 | 321,686,000,000 to 383,266,000,000, median 352,583,000,000 |
| total_liabilities | 28 | 106,869,000,000 to 162,819,000,000, median 135,405,000,000 |
| total_equity | 28 | 50,672,000,000 to 134,047,000,000, median 65,830,000,000 |
| operating_cash_flow | 28 | 23,952,000,000 to 122,151,000,000, median 69,391,000,000 |
| profit_margin | 28 | 3.18 to 7.36, median 4.43 |
| free_cash_flow | 28 | 79,006,000,000 to 176,392,000,000, median 141,120,000,000 |
| capital_expenditure | 28 | 14,288,000,000 to 62,151,000,000, median 30,941,000,000 |
| 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/financials/AAPL%3ANASDAQ" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"currency": "USD",
"annual": [
{
"period": "annual",
"revenue": 391035000000,
"net_income": 93736000000
}
],
"quarterly": []
}
}Request schema
No body schema
Response schema
#/definitions/finance.financialsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | finance.FinancialsResponse | No | ||||
| data.annual | array | No | Annual financial statement rows. | |||
| data.annual[].capital_expenditure | number | No | Capital expenditure for the period. | |||
| data.annual[].ebitda | number | No | Earnings before interest, taxes, depreciation and amortisation for the period. | |||
| data.annual[].eps | number | No | Earnings per share for the period. | |||
| data.annual[].eps_diluted | number | No | Diluted earnings per share for the period. | |||
| data.annual[].free_cash_flow | number | No | Free cash flow for the period. | |||
| data.annual[].net_income | number | No | Net income for the period, in the response currency. | |||
| data.annual[].operating_cash_flow | number | No | Cash flow from operations for the period. | |||
| data.annual[].operating_income | number | No | Operating income for the period. | |||
| data.annual[].operating_margin | number | No | Operating margin for the period. | |||
| data.annual[].pe_ratio | number | No | Price-to-earnings ratio for the period. | |||
| data.annual[].period | string | No | annual | Period label: `annual` when the period ends in December, otherwise `quarterly`. | ||
| data.annual[].period_end | string | No | End date of the reporting period, in UTC (RFC 3339). | |||
| data.annual[].profit_margin | number | No | Profit margin for the period. | |||
| data.annual[].revenue | number | No | Total revenue for the period, in the response currency. | |||
| data.annual[].revenue_growth_yoy | number | No | Revenue growth compared with the same period a year earlier. | |||
| data.annual[].shares_outstanding | number | No | Number of shares outstanding for the period. | |||
| data.annual[].total_assets | number | No | Total assets at the end of the period. | |||
| data.annual[].total_equity | number | No | Total shareholder equity at the end of the period. | |||
| data.annual[].total_liabilities | number | No | Total liabilities at the end of the period. | |||
| data.currency | string | No | USD | Currency code the amounts are reported in, for example `USD`. | ||
| data.quarterly | array | No | Quarterly financial statement rows. | |||
| data.quarterly[].capital_expenditure | number | No | Capital expenditure for the period. | |||
| data.quarterly[].ebitda | number | No | Earnings before interest, taxes, depreciation and amortisation for the period. | |||
| data.quarterly[].eps | number | No | Earnings per share for the period. | |||
| data.quarterly[].eps_diluted | number | No | Diluted earnings per share for the period. | |||
| data.quarterly[].free_cash_flow | number | No | Free cash flow for the period. | |||
| data.quarterly[].net_income | number | No | Net income for the period, in the response currency. | |||
| data.quarterly[].operating_cash_flow | number | No | Cash flow from operations for the period. | |||
| data.quarterly[].operating_income | number | No | Operating income for the period. | |||
| data.quarterly[].operating_margin | number | No | Operating margin for the period. | |||
| data.quarterly[].pe_ratio | number | No | Price-to-earnings ratio for the period. | |||
| data.quarterly[].period | string | No | annual | Period label: `annual` when the period ends in December, otherwise `quarterly`. | ||
| data.quarterly[].period_end | string | No | End date of the reporting period, in UTC (RFC 3339). | |||
| data.quarterly[].profit_margin | number | No | Profit margin for the period. | |||
| data.quarterly[].revenue | number | No | Total revenue for the period, in the response currency. | |||
| data.quarterly[].revenue_growth_yoy | number | No | Revenue growth compared with the same period a year earlier. | |||
| data.quarterly[].shares_outstanding | number | No | Number of shares outstanding for the period. | |||
| data.quarterly[].total_assets | number | No | Total assets at the end of the period. | |||
| data.quarterly[].total_equity | number | No | Total shareholder equity at the end of the period. | |||
| data.quarterly[].total_liabilities | number | No | Total liabilities at the end of the period. | |||
| 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/financials/AAPL%3ANASDAQ" \
-H "x-api-key: $CRAWLORA_API_KEY"