Google Finance API & Scraper
The Google Finance API returns the quotes, charts, financial statements, earnings, analyst ratings, news, insider and politician trades, market movers and calendars that google.com/finance shows, as JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
It reads Google Finance logged out and returns the site's numbers as plain values. `quote` takes a listing as Google writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, EUR-USD, BTC-USD) or a bare ticker, and returns price, change, previous close, open, high, low, 52-week range, volume, average volume, market cap, P/E, EPS, dividend yield, ex-dividend date, beta, shares outstanding and the after-hours price. On 2026-11-15 the API's numbers matched the numbers printed on Google Finance's own quote pages 126 times out of 126 across 14 listings on NASDAQ, NYSE, NSE, BSE, Tokyo, Xetra, London, an ETF, an index, a mutual fund, two currency pairs and Bitcoin. `quotes` returns up to 50 listings in one call. `details` adds the company profile (CEO, employees, founded, headquarters, sector, industry, website), fund facts and the TipRanks news-sentiment outlook. `financials` returns the income statement, balance sheet and cash flow, 94 line items per period, every quarter and fiscal year Google holds (Apple: 112 quarters and 28 years); the last four quarters matched the site's own table 214 times out of 214 for Nvidia, Apple, JPMorgan, SAP and Coca-Cola. `chart` returns 1-minute to weekly prices with OHLC candles. `earnings`, `earnings_call` (timed transcript by speaker), `analyst_ratings`, `analysis`, `key_moments`, `news`, `insider_transactions`, `politician_trades`, `politician_holdings`, `prediction_markets`, `similar` and `related` cover the rest of the quote page. The market pages are `market_movers`, `sectors`, `earnings_calendar` and `market_news` for any of 18 countries, plus `market_summary`, `trending`, `search`, `convert`, `economic_calendar` and `ipo_calendar`.
What a Google Finance field actually contains
Fields that read differently from how they look. Every row was measured against live Google Finance pages on 2026-11-15.
| Field | What it holds |
|---|---|
| symbol | TICKER:EXCHANGE exactly as Google Finance writes it (AAPL:NASDAQ, 7203:TYO, .INX:INDEXSP), or BASE-QUOTE for currency and crypto pairs (EUR-USD, BTC-USD). Seven companies found with `search` opened as the same listing, same id and same price, in `quote`. |
| price and open / day_high / day_low | The source's own value, not the page's rounded display: Nvidia's open is 169.905 where the page prints $169.90. Currency is in `currency` (USD, INR, JPY, EUR; London listings are in GBX, pence). |
| extended_hours | The pre-market or after-hours price with its own change and time; `session` says which. US listings only: 0 of 5 international stocks had one. |
| eps.estimate vs normalized_eps | `eps` is the line the page labels "GAAP EPS / Est." (Apple Q4 2026: 2.10 against 1.99, +5.59 %, beat); `normalized_eps` is the page's "Normalized EPS / Est.". Upcoming quarters carry only the estimates and `report_at`. |
| financials.periods | Every quarter or fiscal year Google holds, newest first, in the company's reporting currency (SAP in EUR). period_end_date is the fiscal period's end; the page's column headers are its month (Nvidia "Jul 2026" = 2026-07-26). |
| beta | Published for US listings only: 0 of 5 international stocks had a beta on Google Finance. |
| fund | Mutual funds only (yield, expense ratio, net assets, Morningstar rating, category, inception). ETFs carry no fund block on Google Finance. |
| market | The country whose market the movers, sectors, earnings calendar and top stories describe. Google Finance shows each visitor their own country's market; this parameter chooses it. 18 countries measured, each answering with its own exchange (London, Frankfurt, Paris, NSE, Tokyo, Toronto, Sydney, São Paulo, Hong Kong, Seoul, Madrid, Milan, Mexico, Singapore, Istanbul, Amsterdam, Zurich and the US). |
| prediction_markets | Kalshi and Polymarket markets linked to the stock. probability_percent is the YES chance ("81.0% chance"); total_volume_usd and average_volume_usd are the market page's "Total volume" and "Avg. vol.". |
Numbers are returned as numbers (5177379608945, not "5.18T"). A listing Google Finance does not know returns NOT_FOUND; in `quotes` it is listed in not_found and the other quotes still return.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/google-finance/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "tesla"
}
}{
"ok": true,
"meta": {
"api": "google-finance",
"endpoint": "search",
"mode": "live",
"latency_ms": 564.3,
"record_count": 5,
"bytes": 4984,
"cache_hit": false,
"upstream_requests": 1,
"charged_credits": 1,
"version": "1.0.0",
"request_id": "d669e15169214afa",
"fetched_at": "2026-11-15T22:38:35.126Z"
},
"data": {
"query": "tesla",
"count": 5,
"results": [
{
"symbol": "TSLA:NASDAQ",
"ticker": "TSLA",
"exchange": "NASDAQ",
"name": "Tesla Inc",
"type": "stock",
"link": "https://www.google.com/finance/quote/TSLA:NASDAQ",
"price": 390.22,
"change": -7.23,
"change_percent": -1.8191,
"previous_close": 397.45,
"currency": "USD",
"country": "US",
"timezone": "America/New_York",
"last_updated_at": "2026-11-14T01:30:00Z",
"regular_close_at": "2026-11-13T21:00:00Z",
"extended_hours": null,
"pair": null,
"google_mid": "/m/0ckhqlx"
},
{
"symbol": "TSLA80:BKK",
"ticker": "TSLA80",
"exchange": "BKK",
"name": "Tesla KTB DR",
"type": "stock",
"link": "https://www.google.com/finance/quote/TSLA80:BKK",
"price": 2.66,
"change": 0.06,
"change_percent": 2.3077,
"previous_close": 2.6,
"currency": "THB",
"country": "TH",
"timezone": "Asia/Bangkok",
"last_updated_at": "2026-11-13T20:15:00Z",
"regular_close_at": "2026-11-13T19:42:58Z",
"extended_hours": null,
"pair": null,
"google_mid": "/g/11xfdd194p"
},
{
"symbol": "TSLA34:BVMF",
"ticker": "TSLA34",
"exchange": "BVMF",
"name": "Tesla Motors Inc BDR",
"type": "stock",
"link": "https://www.google.com/finance/quote/TSLA34:BVMF",
"price": 68.94,
"change": 0,
"change_percent": 0,
"previous_close": 68.94,
"currency": "BRL",
"country": "BR",
"timezone": "America/Sao_Paulo",
"last_updated_at": "2026-11-14T00:00:00Z",
"regular_close_at": "2026-11-13T21:07:00Z",
"extended_hours": null,
"pair": null,
"google_mid": "/g/11c49156gn"
}
]
}
}What the Google Finance API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| quote | Live price snapshot of one listing: price, change, previous close, open / high / low, 52-week range, volume, average volume, market cap, P/E, EPS, dividend yield, beta, the extended-hours price (pre-market / after hours) and the trading session. Works for stocks, ETFs, funds, indexes, futures, currencies and crypto. | Fintech apps call quote to get live price snapshot of one listing. | symbol |
| quotes | Up to 50 live quotes in ONE upstream request (the site's own multi-symbol quote call). Symbols the site does not know are listed in `not_found` instead of failing the call. Bare tickers are resolved together in one extra request. | Portfolio dashboards call quotes to get up to 50 live quotes in ONE upstream request (the site's own multi-symbol quote call). | symbols |
| details | Everything on the quote page's Overview: the quote and key statistics, the company profile (description, CEO, employees, founded, headquarters, sector, industry, website, Wikipedia), fund facts (expense ratio, net assets, yield, category, Morningstar rating), futures facts (settlement, open interest), the currency / crypto legs, the logo, and the TipRanks news-sentiment outlook. | Analysts call details to get everything on the quote page's Overview. | symbol |
| chart | Price history exactly as the page's chart requests it. Window mode: 1D (1-minute points of the session + after hours; 5-minute candles), 5D (30-minute), 1M / 6M / YTD / 1Y (daily), 5Y / MAX (weekly; AAPL MAX: 2,088 weekly bars from 1986-11-14). Range mode: start_date / end_date with an interval (1min … 1week) always returns OHLC candles. `compare` adds up to 7 more symbols in the same request (the page's Compare). | Data teams call chart to get price history exactly as the page's chart requests it. | symbol |
| financials | Income statement, balance sheet and cash flow — every quarter and fiscal year Google holds (AAPL: back to 1999), newest first, 94 line items per period, in the company's reporting currency. | Fintech apps call financials to get income statement, balance sheet and cash flow. | symbol |
| earnings | Every quarter Google tracks for the company: the reported ones (revenue and EPS against the estimate, surprise, beat / miss, normalized EPS) and the scheduled ones (date, estimates). | Portfolio dashboards call earnings to get every quarter Google tracks for the company. | symbol |
| earnings_call | An earnings call: the timed transcript by speaker, audio links, the filed documents, and for the latest call the AI highlights, concerns and the 'At a glance' points with their sources. | Analysts call earnings_call to get an earnings call. | symbol |
| analyst_ratings | Wall Street analyst consensus (TipRanks): buy / hold / sell counts, 12-month price target low / average / high with upside, and every individual rating with firm, action, price target, date, the source article and the analyst's track record. | Data teams call analyst_ratings to get wall Street analyst consensus (TipRanks). | symbol |
| analysis | The quote page's AI analysis: a summary plus the bullish and bearish arguments, each with its cited news sources, and the TipRanks news-sentiment outlook. | Fintech apps call analysis to get the quote page's AI analysis. | symbol |
| key_moments | The chart's 'Key moments': the stock's biggest recent moves, each dated, with the close, the move in percent, an AI explanation, tags and the news sources behind it. | Portfolio dashboards call key_moments to get the chart's 'Key moments'. | symbol |
| news | News about one symbol: the page's 'News stories' from web sources and from Google's news partners (WSJ, Barron's, MarketWatch …), merged newest first. | Analysts call news to get news about one symbol. | symbol |
| insider_transactions | Corporate insiders' buys and sells (SEC Form 4 via TipRanks) from the quote page's Holdings tab, newest first, paged by cursor. | Data teams call insider_transactions to get corporate insiders' buys and sells (SEC Form 4 via TipRanks) from the quote page's Holdings t…. | symbol |
| politician_trades | US Congress members' disclosed trades of the stock (Holdings tab → Politicians), newest first, paged by cursor. | Fintech apps call politician_trades to get uS Congress members' disclosed trades of the stock (Holdings tab → Politicians), newest first…. | symbol |
| politician_holdings | US Congress members' disclosed holdings of the stock (share ranges by disclosure year), paged by cursor. | Portfolio dashboards call politician_holdings to get uS Congress members' disclosed holdings of the stock (share ranges by disclosure year), paged…. | symbol |
| prediction_markets | Kalshi / Polymarket prediction markets Google links to the symbol: question, outcome, YES probability, total and average volume in USD. | Analysts call prediction_markets to get kalshi / Polymarket prediction markets Google links to the symbol. | symbol |
| similar | Listings Google shows as related to the symbol, with live quotes (up to 24, measured). | Data teams call similar to get listings Google shows as related to the symbol, with live quotes (up to 24, measured).. | symbol |
| related | The 'Related stocks' card with earnings: each peer's live quote and its latest reported quarter (revenue and EPS against the estimates). | Fintech apps call related to get the 'Related stocks' card with earnings. | symbol |
| convert | Convert an amount between two currencies or cryptocurrencies at Google Finance's live rate. | Portfolio dashboards call convert to convert an amount between two currencies or cryptocurrencies at Google Finance's live rate.. | from_currency, to_currency |
| search | Google Finance's search box: stocks, ETFs, mutual funds, indexes, futures, currencies, crypto, private companies and prediction markets, best match first (about 5 per asset class, as the site returns). | Analysts call search to get google Finance's search box. | query |
| trending | What Google Finance's empty search box suggests: trending listings, indexes, funds and prediction markets. | Data teams call trending to get what Google Finance's empty search box suggests. | none |
| market_summary | The home page's market tabs: headline indexes for the US, Europe, Asia, India and Latin America, major currencies, crypto and futures, with live quotes. | Fintech apps call market_summary to get the home page's market tabs. | none |
| market_movers | Most active, top gainers and top losers of one country's market (up to 50 each), as the site shows them to a visitor from that country. | Portfolio dashboards call market_movers to get most active, top gainers and top losers of one country's market (up to 50 each), as the site…. | none |
| sectors | The equity-sector index list of a market with the day's move, open, high and low (US: S&P sector indexes, Europe: STOXX 600 sectors, India: NIFTY sectors). | Analysts call sectors to get the equity-sector index list of a market with the day's move, open, high and low (US. | none |
| earnings_calendar | The earnings calendar of a market: yesterday, today, tomorrow, this week, next week, or the home page's upcoming list — each row with the report time, fiscal quarter and the EPS / revenue estimates. | Data teams call earnings_calendar to get the earnings calendar of a market. | none |
| economic_calendar | The home page's economic calendar (LSEG data): upcoming releases worldwide with country, release time, reference period, actual, forecast and prior. | Fintech apps call economic_calendar to get the home page's economic calendar (LSEG data). | none |
| ipo_calendar | IPOs Google Finance tracks: upcoming listings with the filing range and estimated deal size, recent IPOs with the IPO price, first-day close and return, and filings — with industry, SEC filing, underwriters, revenue, net income, quiet-period and lock-up dates. | Portfolio dashboards call ipo_calendar to get iPOs Google Finance tracks. | none |
| market_news | The home page's news for a market: the AI-written market summary stories with their cited sources, the partner top stories, and the latest-news feed. | Analysts call market_news to get the home page's news for a market. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/google-finance/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"tesla"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/google-finance/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "tesla"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/google-finance/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "tesla"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.google-finance.search with {"query":"tesla"}.Who uses this API and why
- Price portfolios and watchlists across exchanges, currencies and crypto in one call.
- Pull standardized quarterly and annual financial statements for screening and models.
- Track earnings dates, estimates, surprises and call transcripts.
- Monitor analyst targets, insider and congressional trades for a list of stocks.
- Show a country's daily movers, sector moves and market news in a dashboard.
Questions developers ask before integrating
Is there a Google Finance API?
Yes. The google-finance API on ReefAPI returns Google Finance quotes, charts, financial statements, earnings, analyst ratings, news, insider and politician trades, market movers and calendars as JSON, read logged out, no Google account needed. Google itself publishes no public API for Google Finance data.
Which markets and asset types are covered?
Every listing Google Finance has: stocks and ETFs on exchanges worldwide, mutual funds, indexes, futures, currency pairs, cryptocurrencies, Kalshi and Polymarket prediction markets and private companies. On 2026-11-15 the API was run on 33 listings across 14 exchanges plus funds, indexes, FX, crypto and futures: 115 of 115 quote calls answered.
How accurate are the prices and statistics?
They are Google Finance's own numbers. Compared with the site's quote pages in the same minute, 126 of 126 values matched (price, open, high, low, market cap, volume, average volume, P/E, 52-week high and low, EPS, beta, shares outstanding, dividend yield) across 14 listings. The analyst consensus matched 20 of 20 values on 4 stocks.
How far back do charts and financials go?
Charts: 1D (1-minute points plus after-hours), 5D, 1M, 6M, YTD, 1Y, 5Y and MAX; Apple's MAX chart is 2,088 weekly bars from November 1986. A date range returns OHLC candles at 1-minute to weekly bars. Financials: every period Google holds, Apple 112 quarters and 28 fiscal years.
Can I get many quotes at once?
Yes. `quotes` returns up to 50 listings in one call; symbols Google does not know are listed in not_found. Bare tickers (AAPL, TSLA) are looked up through Google Finance's own search.
Can I see another country's movers or earnings calendar?
Yes, with `market`: US, GB, DE, FR, IN, JP, CA, AU, BR, HK, KR, ES, IT, MX, SG, TR, NL, CH. Movers give up to 50 gainers, losers and most active each. The earnings calendar has yesterday, today, tomorrow, this week and next week (US next week on 2026-11-15: 51 reports) and lists only what Google shows for that country; some markets list none in a given week.
Are insider and politician trades included?
Yes: insiders' Form 4 buys and sells, US Congress members' trades with amount ranges, and their holdings with share ranges, as the quote page's Holdings tab shows them, paged with next_cursor. Some symbols' politician-trade pages repeat a row the source itself lists twice (2 of 38 on Nvidia).
What is not available?
The quote page's Events tab (dividends and splits) is not part of this API. Google Finance publishes no beta and no after-hours price for non-US listings (0 of 5 international stocks measured had either), and no fund facts for ETFs. Lists and portfolios need a Google login and are not offered.
What is the Google Finance API?
Google Finance API is a ReefAPI endpoint group for google finance quotes for stocks, etfs, funds, indexes, futures, currencies and crypto, with charts, financial statements, earnings, analyst ratings, news, insider and politician trades, market movers and calendars. It returns live JSON through POST requests under /google-finance/v1.
Is the Google Finance API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Google Finance calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Google Finance login or account?
No login to Google Finance is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Google Finance data?
The page example is captured from a live quote call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Google Finance API use?
Google Finance actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Google Finance from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call google-finance actions with the same key, credit pool and JSON envelope used by normal REST requests.