# Google Trends Interest by Region

> Google Trends Interest by Region is a paid API for AI agents from api.kadec0.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-13).

Returns Google Trends subregional interest scores (0–100) for a keyword within a specified country, broken down by state or region.

## Facts

- Endpoint: GET https://api.kadec0.xyz/v1/interest-by-region
- 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-interest-by-region-f1427195
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u2zB5ZoItr6CIH1m9AJrw

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-by-region-f1427195
```

Example prompt: Show me which US states are most interested in 'electric vehicles' on Google Trends over the past 12 months — give me the regional breakdown scored 0 to 100.

## When to prefer this

Choose this endpoint when you need geographic distribution of search interest within a country — i.e., which states or regions are driving interest in a keyword — rather than overall trend over time. Ideal for market segmentation, regional campaign targeting, or geographic demand analysis. Prefer this over global-level trend APIs when the use case is intra-country comparison.

## Known failure modes

- Missing required 'keyword' or 'geo' parameter returns a 400 validation error
- Invalid or unsupported country code for 'geo' may return empty results or an error
- Very obscure keywords with near-zero search volume may return all-zero scores
- Rate limiting or upstream Google Trends throttling may cause intermittent failures
- Extremely short timeframes (e.g. past_hour) may yield sparse or empty regional data

## How this service works

Google Trends interest by region for a keyword. Returns the subregional breakdown of Google Trends search interest inside a country - by state, province, or region - each ranked 0-100 relative to the strongest region. For regional demand mapping, geo targeting, and finding where a keyword over-indexes before spending on it.

## Output

Returns a ranked list of subregions (states, provinces, or equivalent) within the specified country, each with an interest score from 0 to 100, where 100 represents the region with the highest relative search interest. Also includes metadata such as granularity of the time series bucket (hourly, daily, or weekly depending on the timeframe selected).

## 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",
      "geo"
     ],
     "properties": {
      "geo": {
       "type": "string",
       "description": "ISO-3166 alpha-2 country code, e.g. US, GB, DE, JP (213 countries supported)"
      },
      "keyword": {
       "type": "string",
       "description": "the search term"
      },
      "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-by-region-f1427195/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)