# Google Finance Markets API (https://www.socialcrawl.dev/platforms/google_finance/markets)

> Returns a unified QuoteList snapshot of the global markets overview: the major regional indices (US / Europe / Asia, tagged in `quote.ext.section`) plus the day's most-active, gainers, and losers movers. Each row is the same canonical Quote shape used everywhere — re-feed any `id` into /v1/google_finance/quote for the full detail. A standing overview (no input required); the regional grouping is baked into the single response. Sourced live from DataForSEO's Google Finance SERP (~4-8s).

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `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/markets" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a stock market overview from an API?

Send a GET request to /v1/google_finance/markets — no required parameters. You get a standing overview: major regional indices and the day's movers, all flattened into one list of canonical Quotes (about 47 rows across 10 sections).

### What indices and movers does the markets endpoint return?

Major US, Europe, and Asia indices (tagged in quote.ext.section) plus the day's most-active, gainers, and losers. Live runs return ~47 rows across 10 sections, each a canonical Quote you can read with the same code as a single ticker.

### Does the markets endpoint need any parameters?

No required parameters — a bare GET to /v1/google_finance/markets works. Optional language and location parameters localize the overview, but the default call returns the standard US, Europe, and Asia market snapshot.

### How do I tell indices apart from movers in the response?

Each row is tagged in quote.ext.section, so you can split regional indices from the most-active, gainers, and losers groups. Everything is the same Quote shape, so one parser handles indices and movers alike.

### How much does the markets endpoint cost?

The markets overview is 1 credit per call on the standard tier, however many rows come back. New accounts get 100 free credits with no credit card required, so you can build a markets dashboard before paying anything.

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 live stock market overview with the SocialCrawl API
- What does the SocialCrawl markets endpoint return?