# Google Search Keyword Volume API (https://www.socialcrawl.dev/platforms/google/keyword-volume)

> Returns Google monthly search volume, cost per click, competition, and a 12-month trend for up to 20 keywords in one country. Response is `{ location, location_name, language, items }`: each item carries `keyword`, `search_volume` (average monthly searches), `cpc` with its `currency`, `competition` (0 to 1) with `competition_level`, `monthly_searches` (the last 12 months, oldest first, as `{ year, month, search_volume }`) and, where Google classifies it, `search_intent`. Use it to compare demand for a product across markets: call it once per country with the same keywords. You get one item per keyword you asked for, in your order. A keyword Google holds no volume for comes back with `search_volume: null`, never 0, so a null means unknown and a 0 means Google reports none. Every null row says why in `null_reason`: `"withheld"` means Google stopped publishing volume for the term (since December 2023 it withholds many health and other sensitive terms, such as "shingles" or "herniated disc"), and such a row carries `last_reported` (`{ year, month, search_volume }`, the last month Google published a figure) with an empty `monthly_searches`; `"no_data"` means Google holds no figure at all (very rare or unknown terms). For relative interest in a withheld term, use `/v1/google_trends/explore`, or `/v1/naver/search-trend` in Korea. When no keyword has current volume the call returns 404 and costs 0 credits; its message lists the last published figures. Volumes are Google's own rounded monthly averages and are refreshed monthly, so results are cached for 24 hours. Typical latency is 2 seconds. Priced at a flat 16 credits per call whatever the keyword count, so send all 20 at once.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `keywords` | yes | 1-20 comma-separated keywords (e.g. 'lip gloss,lip oil'). Each keyword may be up to 80 characters. Duplicates are ignored. More than 20 keywords, or a keyword over 80 characters, is rejected with a free 400 before the request is billed. |
| `location` | no | Country as an ISO code ('US', 'GB', 'KR'), a full country name ('United Kingdom', 'South Korea') or a numeric location code ('2826'). Defaults to the United States. Volume is published for 94 countries; any other location is rejected with a free 400 naming the accepted forms. |
| `language` | no | Language code ('en', 'de', 'ko') the keywords are searched in. Defaults to the first language listed for the country: Germany is 'de' and Belgium is 'fr', but Vietnam, Indonesia, India, Malaysia, Pakistan, the Philippines, Hong Kong and Singapore default to 'en', so pass their local language (e.g. 'vi', 'id', 'hi') explicitly. A language the country does not hold (Germany in English) is rejected with a free 400 listing the ones it does. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/google/keyword-volume" \
  --data-urlencode "keywords=lip gloss,lip oil" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the keyword volume API return?

For up to 20 keywords in one country it returns search_volume (average monthly searches), cpc with its currency, competition (0 to 1) with competition_level, monthly_searches for the last 12 months oldest first, and search_intent where Google classifies it. You get one item per keyword, in your order.

### How do I call the keyword volume API?

Send a GET request to /v1/google/keyword-volume with keywords (comma-separated, 1 to 20, each up to 80 characters) and an x-api-key header. Add location (an ISO code such as GB or KR, or a country name) and language ('en', 'de', 'ko') when you do not want the United States default.

### How much does a keyword volume call cost?

A call costs 16 credits on the premium tier whatever the keyword count, so send all 20 at once. When no keyword has current volume the call returns 404 and costs 0 credits, and credits for failed or empty calls are refunded automatically.

### Why is search_volume null for some keywords?

null means unknown, and 0 means Google reports none. Each null row carries null_reason: withheld means Google stopped publishing volume for the term (many health terms since December 2023), and the row then holds last_reported with the last published month. no_data means Google holds no figure at all.

### How do I get demand for a withheld keyword?

Use /v1/google_trends/explore for relative interest over time, or /v1/naver/search-trend in Korea. Both give a trend curve instead of a monthly count.

### How fresh is the volume, and can I compare countries?

Volumes are Google's own rounded monthly averages, refreshed monthly, so results are cached for 24 hours. To compare demand across markets, call once per country with the same keywords. Typical latency is 2 seconds.

See the full Google Search API: https://www.socialcrawl.dev/platforms/google

## 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:

- Is there an API for Google keyword search volume?
- How do I get monthly search volume and CPC for 20 keywords in one API call with SocialCrawl?
- Which keyword volume API returns a 12-month trend per keyword?