The playground

Try any of 1042 endpoints — live.

Pick an endpoint, load a working example, tweak the params, and send — no signup to try. Results render the way the data deserves; raw JSON, headers & code are one tab away.

Playground demo key · api.reefapi.com
post/google-trends/v1/interest_by_region1 credit

Search interest by sub-region (states/countries), 0-100 normalized — single keyword; multiple keywords returns the compared breakdown by region (per-keyword %-share)

Working example
Parameters

The search term to analyze (e.g. 'bitcoin'). For multi-term compare use 'keywords'.

Up to 5 terms to compare (array, or a comma-separated string). When given, overrides 'keyword'; extras beyond 5 are dropped.

Geography filter: empty = Worldwide; a country code (US, GB, DE) or a sub-region code (US-CA, GB-ENG). Omit for worldwide.

Date range in Google Trends syntax, e.g. 'today 12-m', 'today 5-y', 'now 7-d', 'all', or an explicit 'YYYY-MM-DD YYYY-MM-DD'.

interest_by_region granularity. Defaults to the geo's natural level; an unrecognized value is ignored.

Google Trends category id to narrow the topic (0 = All categories). e.g. 7=Finance, 5=Computers & Electronics. (0–)

Which Google property's search interest to measure. Empty = web search.

request preview
curl -X POST https://api.reefapi.com/google-trends/v1/interest_by_region \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"keyword":"bitcoin","geo":"US","timeframe":"today 12-m"}'

Hit Send to run this endpoint live.