# Google Trends Rising API (https://www.socialcrawl.dev/platforms/google_trends/rising)

> Returns the related search queries for ONE keyword as `{ rising, top }`. `rising` is the breakout list: queries whose search interest grew the most over the window, each with a `growth` percentage (a true breakout can read into the thousands, e.g. 3200 = +3200%). Google's own "Breakout" rows (growth above +5000%) carry `is_breakout: true`; when Google gives no percentage for one, `growth` is null rather than an invented number, and rows with a number carry `is_breakout: false`; `top` is the most-searched related queries, each with a 0-100 relative `value`. The closest thing to a 'breakout terms' primitive: pair it with /v1/google_trends/explore to size a trend and find the queries driving it. A keyword with too little search volume in the requested location and window to build a related-query list returns 404 at 0 credits: that is a fact about the KEYWORD, not an unsupported location, and the same location will answer 200 for a keyword people there actually search. Widen `timeframe` or use the keyword in the local language before concluding a location is unavailable. 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/rising` 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 | Single keyword to expand (e.g. 'uv index'). Google Trends returns the related-queries list for one keyword only, so a comma-separated value is rejected with a free 400 before the request is billed. The keyword must be 2 to 100 characters; use /v1/google_trends/explore for multi-keyword comparisons. |
| `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 related-query lists (default 0 = all categories). The same codes /v1/google_trends/explore accepts; 0 is every category. A non-numeric value is rejected with a free 400. |

## Code example

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

## FAQ

### What does the Google Trends Rising API return?

Returns related searches for one keyword in two lists: rising queries with their growth percentage, and top queries with a 0 to 100 popularity score. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Google Trends Rising endpoint?

Use it to find the breakout searches driving a trend, after explore has shown you how big that trend is.

### How much does the Google Trends Rising API cost?

Each call costs 5 credits, so the 100 free credits every new account gets cover 20 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Google Trends Rising API need?

The one required parameter is keyword (single keyword to expand e.g). It also accepts 3 optional parameters, all listed on this page.

### How do I call the Google Trends Rising API?

Send a GET request to https://www.socialcrawl.dev/v1/google_trends/rising?keyword=uv%20index with your API key in the x-api-key header. An Authorization: Bearer header works too.

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:

- What does the SocialCrawl Google Trends Rising API return?
- How do I get Google Trends Rising data with the SocialCrawl API?