# Google Trends Interest Over Time

> Google Trends Interest Over Time is a paid API for AI agents from api.kadec0.xyz, paid per call via x402, $0.05/call, status healthy (last checked 2026-09-15, last successful call 2026-09-09).

Returns a dated time series (indexed 0–100) of Google search interest for a keyword, with configurable time window and optional country filter.

## Facts

- Endpoint: GET https://api.kadec0.xyz/v1/trend
- Price: $0.05/call
- Payment: x402
- Status: healthy
- Last checked: 2026-09-15
- Last successful call: 2026-09-09
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-trends-interest-over-time-b92770b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ps-ENky32FKiIprxMzGKT

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-b92770b0
```

Example prompt: Can you pull the Google Trends interest over time for 'electric vehicles' in the US over the past 12 months and show me how interest has changed week by week?

## When to prefer this

Use this endpoint when you need a normalized, time-series view of Google search interest for a specific keyword, especially when you require country-level filtering or flexible time windows from the past hour all the way back to 2004. Prefer this over general web search endpoints when the goal is trend analysis, seasonality detection, or interest tracking rather than finding specific web pages or documents.

## Known failure modes

- Missing required 'keyword' parameter returns a validation error
- Invalid or unsupported country code in 'geo' returns an error or empty result
- Keyword with no search data in the selected window may return all-zero series
- Payment failure (x402) if USDC balance is insufficient — call is not executed
- Rate limiting or upstream Google Trends unavailability may cause 5xx errors

## How this service works

Google Trends interest over time for a keyword. Returns Google Trends search interest as a dated series indexed 0-100: weekly points across the default past 12 months, daily points for 30- and 90-day windows, and windows from the past hour back to 2004, with optional country targeting. For keyword trend analysis, search demand seasonality, and SEO keyword research.

## Output

A dated time series of interest scores from 0 to 100 for the specified keyword, where 100 represents peak popularity. Each data point corresponds to a time bucket whose size depends on the timeframe (hourly for sub-day windows, daily for 30/90-day windows, weekly for 12-month/5-year windows). The response also includes a granularity field indicating the bucket size used.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "keyword"
     ],
     "properties": {
      "geo": {
       "type": "string",
       "description": "ISO-3166 alpha-2 country code, e.g. US, GB, DE, JP (213 countries supported); omit for worldwide"
      },
      "keyword": {
       "type": "string",
       "description": "the search term to chart"
      },
      "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. Each response reports its own bucket size in `granularity`: past_30_days and past_90_days return a daily series, past_12_months and past_5_years weekly, windows under a day hourly"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

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