# Google Finance Quote API (https://www.socialcrawl.dev/platforms/google_finance/quote)

> Returns ONE rich, unified Quote for a financial instrument keyed by its `keyword` (`TICKER:EXCHANGE` for stocks/ETFs/indices, e.g. 'GOOGL:NASDAQ' / 'VOO:NYSEARCA' / '.INX:INDEXSP', or a forex/crypto pair, e.g. 'EUR-USD' / 'BTC-USD'). A single call bundles the live price + intraday graph, fundamentals (market cap, P/E, dividend yield, 52-week range, volumes), the company profile (CEO, founded, HQ, employees), quarterly + annual financials (equities), and peer instruments — all on ONE canonical shape across stocks, ETFs, indices, crypto, and forex, distinguished by `quote.type`. Forex/crypto pairs populate `quote.pair` (base/quote symbols) and have a null `ticker`. Get the exact `keyword` from /v1/google_finance/ticker-search. Sourced live from DataForSEO's Google Finance SERP (~5-10s).

TL;DR: `GET /v1/google_finance/quote` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `keyword` | yes | Instrument identifier: TICKER:EXCHANGE for stocks/ETFs/indices ('GOOGL:NASDAQ', '.INX:INDEXSP') or a forex/crypto pair ('EUR-USD', 'BTC-USD'). Use the `id` returned by ticker-search. |
| `language` | no | Language as a DFS name ('English') or 2-letter code ('en'). Defaults to English. |
| `location` | no | Location as a DFS name ('United States') or numeric code ('2840'). Defaults to the US. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/google_finance/quote?keyword=GOOGL%3ANASDAQ" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a real-time stock quote from an API?

Send a GET request to /v1/google_finance/quote with keyword=GOOGL:NASDAQ. One call returns live price, the intraday graph (hundreds of points), metrics like P/E and market cap, company about, financials, and peers as a unified Quote JSON.

### What data does the stock quote endpoint return?

A single Quote with live price, intraday graph (GOOGL returns ~525 points), metrics (market cap, P/E, dividend yield, 52-week range, volumes), about (CEO, founded, HQ, employees), quarterly and annual financials, and peers (4 for GOOGL).

### Can I get crypto and forex prices from the quote API?

Yes. Pass a pair like BTC-USD or EUR-USD as the keyword. Crypto and forex return as asset pairs — quote.pair holds the base and quote symbols, and ticker is null. It is the same Quote shape you use for stocks.

### How fresh are the prices and is the quote cached?

Prices are time-sensitive, so the quote response is cached for only 60 seconds. The whole call is synchronous — one GET, roughly 3 to 15 seconds — with no polling or task IDs to manage.

### How much does a stock quote cost and what if the ticker is invalid?

Each quote is 5 credits on the advanced tier, regardless of how much data the instrument returns. A nonexistent ticker returns a 404 and the 5 credits are automatically refunded. New accounts get 100 free credits, no card.

See the full Google Finance API: https://www.socialcrawl.dev/platforms/google_finance

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get a real-time stock quote with the SocialCrawl API
- What does the SocialCrawl stock quote endpoint return?