docs / google-trends

Google Trends

Search interest over time, by region, and trending now.

base /google-trends/v15 endpoints

post/google-trends/v1/interest_over_time1 credit

Search-interest timeline (0-100) for a keyword or up to 5 compared keywords, by geo+timeframe

Parameter	Required
keyword	required
keywords	optional
geo	optional
timeframe	optional
category	optional
property	optional

Try in playground →

post/google-trends/v1/related_queries1 credit

Top + rising related search queries for a keyword (rising shows Breakout / +%)

Parameter	Required
keyword	required
geo	optional
timeframe	optional
category	optional
property	optional

Try in playground →

post/google-trends/v1/related_topics1 credit

Top + rising related topics (entity mid+title) — Google currently throttles this widget to empty; wired + self-healing (use related_queries for keyword data)

Parameter	Required
keyword	required
geo	optional
timeframe	optional
category	optional
property	optional

Try in playground →

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)

Parameter	Required
keyword	required
keywords	optional
geo	optional
timeframe	optional
resolution	optional
category	optional
property	optional

Try in playground →

post/google-trends/v1/trending_now1 credit

Currently trending searches for a geo (title + approx traffic + news articles)

Parameter	Required
geo	optional

Try in playground →

Example request · interest_over_time

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

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}