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. This is a fixed-rate data call, 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.
`language`optional	string	Optional ISO-2 language code for the related-query text. Defaults to the language of the `geo` country, so "Germany" returns German queries. Google Trends accepts any language with any location.

Request

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

Response

{
  "term": "AI-powered CRM",
  "trend": "rising",
  "interestOverTime": [
    {
      "date": "2026-07-13",
      "value": 72
    }
  ],
  "risingQueries": [
    "AI sales automation",
    "CRM copilot"
  ],
  "topQueries": [
    "AI CRM for startups"
  ],
  "requestId": "…",
  "billing": {
    "cost": {
      "microCredits": 5000,
      "usd": "0.05"
    },
    "balance": {
      "microCredits": 1336000,
      "usd": "13.36"
    }
  }
}