# Google Trends Search Interest API

> Google Trends Search Interest API is a paid API for AI agents from seo.openverbs.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-13).

Returns relative search popularity (0-100) time series for up to 5 keywords from Google Trends, with per-keyword averages and latest values.

## Facts

- Endpoint: POST https://seo.openverbs.com/v1/trends
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-trends-search-interest-api-74e8bc52
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k-9avX9YlnaCuCXQC6t8U

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-search-interest-api-74e8bc52 -d '<json body>'
```

Example prompt: Can you pull Google Trends data for 'trail running shoes' vs 'road running shoes' in the United States over the past 12 months so I can see which has more consistent search demand?

## When to prefer this

Use this endpoint when you need relative search popularity trends over time for content timing, seasonality analysis, or competitive demand research. It is ideal when you want to compare multiple terms head-to-head (up to 5) and understand momentum or cycles. Prefer this over keyword volume endpoints when you care about trend direction and relative interest rather than absolute monthly search counts.

## Known failure modes

- found=false when Google Trends has no data for the given keywords or region combination
- Up to 5 keywords max — exceeding this limit returns a validation error
- Invalid location name returns an error or empty data
- Invalid timeframe enum value returns a validation error
- Very niche or brand-new terms may return sparse or zero data points

## How this service works

Google Trends search interest for up to 5 terms: a relative 0-100 popularity series over time, with per-keyword average and latest value. For content timing, seasonality and demand research. Optional location (default worldwide), timeframe (7d/30d/90d/12m/5y, default 12m) and type (web/news/youtube). found=false when no data.

## Output

A time series of relative popularity scores (0-100) for each keyword, normalized so the peak value is 100. Each keyword also gets a computed average score and its latest value. If no data is found for a query, found=false is returned. Results can be scoped by location, timeframe, and Google property (web, news, or YouTube).

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "keywords": {
       "type": "array",
       "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
       },
       "minItems": 1,
       "maxItems": 5,
       "description": "1-5 terms to compare, e.g. [\"running shoes\", \"trail running shoes\"]."
      },
      "location": {
       "type": "string",
       "minLength": 2,
       "maxLength": 120,
       "description": "Market name, e.g. \"United States\". Omit for worldwide interest."
      },
      "timeframe": {
       "type": "string",
       "enum": [
        "7d",
        "30d",
        "90d",
        "12m",
        "5y"
       ],
       "description": "Time window: 7d, 30d, 90d, 12m or 5y (default 12m)."
      },
      "type": {
       "type": "string",
       "enum": [
        "web",
        "news",
        "youtube"
       ],
       "description": "Google property: web, news or youtube (default web)."
      }
     },
     "required": [
      "keywords"
     ],
     "additionalProperties": false
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/google-trends-search-interest-api-74e8bc52/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from seo.openverbs.com](https://www.zero.xyz/host/seo.openverbs.com/llms.txt)
