# Google Trends Interest Over Time

> Google Trends Interest Over Time is a paid API for AI agents from agent.chiemgaufilms.com, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-28).

Returns relative search interest (0–100) over the past 12 months for up to 5 compared keywords, by country and language, powered by DataForSEO Google Trends Explore Live.

## Facts

- Endpoint: POST https://agent.chiemgaufilms.com/api/v1/google-trends?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-trends-interest-over-time-5b396430
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ln_HoBBaW11FDk7Dew-bE

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-5b396430 -d '<json body>'
```

Example prompt: Can you compare the Google search interest trends over the past 12 months for 'running shoes', 'trail shoes', and 'hiking boots' in the United States?

## When to prefer this

Choose this endpoint when you need relative, time-series search interest data for keyword comparison rather than absolute search volume numbers. It is ideal for trend direction analysis, seasonal demand insights, and competitive keyword benchmarking over a 12-month window. Prefer this over keyword volume tools when the goal is to compare multiple terms against each other on a normalized 0–100 scale. Use sibling endpoints like Keyword Ideas or Keyword Difficulty when you need absolute volume or ranking difficulty metrics instead.

## Known failure modes

- Unsupported country/language pair causes rejection before payment is processed
- More than 5 keywords in the array returns a validation error
- Keyword string exceeding 80 characters or 10 words is rejected
- Invalid location_code (not a recognized DataForSEO country-level code) returns an error
- Misspelled or unrecognized language_code pattern causes refusal
- Very niche or brand-new keywords may return all-zero interest values if no data exists

## How this service works

Google Trends interest over time (past 12 months, relative 0-100) for up to 5 keywords compared against each other (DataForSEO Google Trends Explore Live).

## Output

A JSON object containing a 'keywords' array (the queried terms), 'location_code', 'language_code', and a 'points' array of weekly time-series entries. Each point includes a 'date_from' and 'date_to' (ISO date strings) and a 'values' array of relative interest scores (0–100) aligned positionally to the keywords array.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "keywords": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 80,
    "minLength": 1
   },
   "maxItems": 5,
   "minItems": 1
  },
  "language_code": {
   "type": "string"
  },
  "location_code": {
   "type": "integer",
   "default": 2840,
   "maximum": 99999999,
   "minimum": 1000
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "points": [
   {
    "values": [
     45,
     12
    ],
    "date_to": "2025-10-18",
    "date_from": "2025-10-12"
   }
  ],
  "keywords": [
   "running shoes",
   "trail shoes"
  ],
  "language_code": "en",
  "location_code": 2840
 }
}
```

## More

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