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 creditSearch-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 |
post
/google-trends/v1/interest_by_region1 creditSearch 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 |
post
/google-trends/v1/trending_now1 creditCurrently trending searches for a geo (title + approx traffic + news articles)
| Parameter | Required |
|---|---|
| geo | optional |
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
}