# Google Trends Explore API (https://www.socialcrawl.dev/platforms/google_trends/explore)

> Returns Google Trends interest-over-time for up to 5 keywords in one call. Response is `{ series, averages }`: `series` is one entry per keyword, each with dated `points` ({ date, datetime, value, partial }) where `value` is Google's 0-100 relative-popularity score; `averages` is the per-keyword mean over the window. `partial` is true on a bucket Google is still accumulating, which is normally the last point: treat it as an incomplete count rather than a fall in interest, and drop it before charting a trend. Compare terms head-to-head (values are normalised across the keyword set) and scope by `location`, `timeframe`, and `category`. A keyword set with no measurable search interest returns 404 and costs 0 credits, so a dead term is never billed. A billed refresh is typically 5-9s and the slow tail reaches about 30s, so set a client timeout of at least 60s: this surface reads Google Trends live and Google itself is the slow part. Exact repeats may use the 2-minute search cache and return in milliseconds at 0 credits.

TL;DR: `GET /v1/google_trends/explore` 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 |
| --- | --- | --- |
| `keywords` | yes | 1-5 comma-separated keywords (e.g. 'reverse audio,voice changer'). With multiple keywords the 0-100 values are normalised across the set for direct comparison. Each keyword must be 2 to 100 characters. More than 5 keywords, a 1-character keyword, or a keyword made only of punctuation is rejected with a free 400 before the request is billed. |
| `location` | no | Location as an ISO country code ('US', 'KR'), a full country name as Google Trends spells it ('United States', 'South Korea'), or a numeric location code ('2840'). Common spellings and ISO codes are normalised, so 'KR', 'Korea' and 'South Korea' all reach the same place. Google Trends does not publish every country, and a location it has no data for is rejected with a free 400 naming the accepted forms; a 404 means the keyword had no data there, not that the location is unsupported. Defaults to worldwide-leaning US. |
| `timeframe` | no | Preset time window: past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, or past_5_years. Defaults to past_12_months. (past_hour \| past_4_hours \| past_day \| past_7_days \| past_30_days \| past_90_days \| past_12_months \| past_5_years) |
| `category` | no | Numeric Google Trends category code to scope the query (default 0 = all categories). A non-numeric value is rejected with a free 400 rather than silently returning an all-categories series. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/google_trends/explore" \
  --data-urlencode "keywords=uv index" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get Google Trends data through an API?

Send a GET request to /v1/google_trends/explore with 1 to 5 comma-separated keywords and an x-api-key header. The response is { series, averages }: each series has dated points with Google's 0 to 100 relative-popularity value, and averages holds the mean per keyword over the window.

### Can I compare several keywords in one call?

Yes, up to 5. With more than one keyword the 0 to 100 values are normalised across the set, so the terms compare head to head. More than 5 keywords, a 1-character keyword, or a keyword made only of punctuation is rejected with a free 400.

### Which timeframes, countries and categories can I use?

timeframe takes past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months (the default) or past_5_years. location takes a country code such as US or KR, or a country name. category takes a numeric Google Trends category code, and 0 means all.

### What does partial mean on a data point?

partial is true on a bucket Google is still accumulating, normally the last point. Treat it as an incomplete count rather than a fall in interest, and drop it before charting a trend.

### What happens when a keyword has no search interest?

A keyword set with no measurable search interest returns 404 and costs 0 credits, so a term nobody searches is never billed. A 404 means the keyword had no data in that place, not that the location is unsupported.

### How much does the Google Trends data API cost, and how fast is it?

Each call costs 5 credits on the advanced tier. A billed refresh typically takes 5 to 9 seconds and the slow tail reaches about 30, so set a client timeout of at least 60 seconds. Exact repeats within 2 minutes can come from cache at 0 credits.

See the full Google Trends API: https://www.socialcrawl.dev/platforms/google_trends

## 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 do I get Google Trends interest over time data with an API?
- Does SocialCrawl offer a Google Trends data API for comparing keywords?
- What is the easiest API for Google Trends keyword comparison?