Trends

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

Overview

Your agent gets interest-over-time, related and rising queries, and a derived rising/falling/stable label for a term via Google Trends. Like keywords, it’s a flat per-call data tool, not a per-model AI call.

Example

Ask your agent in plain English and it calls the tool for you:

# you say
Is “generative engine optimization” trending up over the past year, and what related searches are rising?

The tool returns structured JSON to your agent (you never see this directly):

{
  "term": "generative engine optimization",
  "trend": "rising", "changeYoy": 0.53,
  "risingQueries": ["geo vs seo", "geo agency"],
  "billing": { "cost": { "usd": "0.05" } }
}

Your agent reads that JSON and answers you in plain English. That reply is written by your own AI; the JSON is just what it reasons over:

# your AI replies
Yes, it’s rising, up 53% year over year. The searches climbing fastest are “geo vs seo” and “geo agency”, so there’s growing demand for both comparisons and done-for-you help.

Full input and output schema: POST /v1/trends. Pass an optional models list to narrow which models run (see per-model pricing).