Trends

Google Trends interest-over-time, related and rising queries, and a trend label for a term. Flat per call.

Overview

Interest-over-time, related and rising queries, and a derived rising/falling/stable label for a term, via Google Trends. Like /v1/keywords, this is a flat per-call data endpoint, not a per-model AI call. timeframe accepts tokens like past_12_months, past_30_days, past_5_years.

Reference

POST/v1/trends

$0.05 · flat per call

Parameters

`term`required	string	Search term to pull Google Trends interest-over-time for.
`timeframe`optional	string	Trends window, e.g. "past_12_months", "past_30_days", "past_5_years". Default: `"past_12_months"`.
`geo`optional	string	Optional location name (e.g. "United States"). Worldwide when omitted.

Request

curl https://api.cite42.dev/v1/trends \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "term": "generative engine optimization", "timeframe": "past_12_months" }'

Response

{
  "term": "generative engine optimization",
  "trend": "rising",
  "changeYoy": 0.53,
  "interestOverTime": [ { "date": "2025-05-18", "value": 17 } ],
  "risingQueries": ["geo vs seo", "geo agency"],
  "topQueries": ["what is geo"],
  "requestId": "…",
  "billing": { "cost": { "usd": "0.05" }, "balance": { "usd": "13.31" } }
}