# Google Trends Interest Over Time

> Google Trends Interest Over Time is a paid API for AI agents from google-trends.use.x402atlas.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Returns a dated 0-100 relative search-interest time series for a keyword, with configurable country targeting and time window granularity (hourly to monthly).

## Facts

- Endpoint: GET https://google-trends.use.x402atlas.com/trend-over-time?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-trends-interest-over-time-6550ae99
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4lsvmUFbhUFNMzYfDe5ft

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability google-trends-interest-over-time-6550ae99
```

Example prompt: Can you pull the Google Trends interest-over-time data for 'electric vehicles' in the US over the past 12 months? I want to see the weekly 0-100 index to understand seasonal demand patterns.

## When to prefer this

Use this endpoint when you need a time-series view of search interest for a specific keyword — ideal for trend analysis, seasonality research, SEO content timing, and market demand tracking. Prefer this over the related-queries or interest-by-region endpoints when the user's primary question is 'how has interest changed over time?' rather than 'where is this popular?' or 'what related terms are rising?'. Choose this over generic SEO tools when you need raw, date-stamped Google Trends data with configurable geographic and time-window targeting at a per-call cost.

## Known failure modes

- Keyword has insufficient search volume — returns zero or near-zero series
- Invalid or unsupported country code — may return error or fall back to worldwide
- Keyword too long (over 100 characters) — schema validation error
- Timeframe enum value misspelled — request rejected
- Rate limiting or payment failure — 402 or 429 response
- Google Trends upstream unavailability — degraded or fallback response with notice field

## How this service works

Google Trends interest over time for a keyword — search interest as a dated 0-100 series with country targeting (geo) and timeframe windows from the past hour back to 2004: daily points for 30/90-day windows, weekly for 12 months/5 years. For keyword trend analysis, search demand seasonality and SEO keyword research.

## Output

A JSON object containing the keyword, geo (country code or 'worldwide'), timeframe, granularity (hourly/daily/weekly/monthly), data source, query timestamp, and a 'series' array of date-value objects where each value is an integer 0-100 representing relative search interest at that point in time (100 = peak within the window). May include a 'notice' field if a degraded fallback response was served.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "keyword"
     ],
     "properties": {
      "geo": {
       "type": "string",
       "default": "worldwide",
       "maxLength": 8,
       "description": "ISO-3166 alpha-2 country code, e.g. US, GB, DE, JP (213 countries supported); case-insensitive; also accepted as country; omit for worldwide"
      },
      "keyword": {
       "type": "string",
       "maxLength": 100,
       "description": "Concise Google Trends seed term with meaningful search interest; not a question, instruction, or web-search request"
      },
      "timeframe": {
       "enum": [
        "2004_present",
        "past_12_months",
        "past_30_days",
        "past_4_hours",
        "past_5_years",
        "past_7_days",
        "past_90_days",
        "past_day",
        "past_hour"
       ],
       "type": "string",
       "default": "past_12_months",
       "description": "Time window. Bucket size follows the window and is reported in granularity: past_30_days/past_90_days daily, past_12_months/past_5_years weekly, 2004_present monthly, shorter windows hourly or finer"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "keyword",
      "geo",
      "timeframe",
      "granularity",
      "data_source",
      "queried_at",
      "series"
     ],
     "properties": {
      "geo": {
       "type": "string",
       "description": "Location actually served: upper-cased country code, or worldwide"
      },
      "notice": {
       "type": "string",
       "description": "Present only on a degraded fallback response; explains what was served instead"
      },
      "series": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "date",
         "value"
        ],
        "properties": {
         "date": {
          "type": "string",
          "format": "date",
          "description": "UTC calenda
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/google-trends-interest-over-time-6550ae99/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from google-trends.use.x402atlas.com](https://www.zero.xyz/host/google-trends.use.x402atlas.com/llms.txt)