# 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 current stock quote from an API?

Send a GET request to /v1/google_finance/quote with keyword=GOOGL:NASDAQ. One call returns a recent market snapshot with the current public price, intraday graph, metrics such as P/E and market cap, company details, financials, and peers as a unified Quote JSON.

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

A single Quote with the current public price, intraday graph (GOOGL returns ~525 points), metrics (market cap, P/E, dividend yield, 52-week range, volumes), company details (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?

On a cache miss, the quote endpoint fetches a current public market snapshot. Exact repeats use a 60-second cache and cost 0 credits, so a cache hit is free. Send Cache-Control: no-cache for a billed refresh. Prices may also reflect exchange delay. 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 current stock quote with the SocialCrawl API
- What does the SocialCrawl stock quote endpoint return?