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 Kingdom"). Defaults to the United States when omitted.

Request

curl https://www.cite42.dev/api/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",
  "interestOverTime": [
    {
      "date": "2026-07-13",
      "value": 72
    }
  ],
  "risingQueries": [
    "geo vs seo",
    "geo agency"
  ],
  "topQueries": [
    "what is geo"
  ],
  "requestId": "…",
  "billing": {
    "cost": {
      "microCredits": 5000,
      "usd": "0.05"
    },
    "balance": {
      "microCredits": 1336000,
      "usd": "13.36"
    }
  }
}