# Keyword Monthly Search Volume History

> Keyword Monthly Search Volume History is a paid API for AI agents from seo.openverbs.com, paid per call via x402, $0.15/call, status unknown (last checked 2026-10-12).

Returns a month-by-month search volume time series (back to 2019) for up to 10 keywords, plus current CPC and competition level.

## Facts

- Endpoint: POST https://seo.openverbs.com/v1/keyword-volume-history?utm_source=zero.xyz
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/keyword-monthly-search-volume-history-2c6fbd76
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Gc9HM6mTBhAOw1s9GvxBB

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 keyword-monthly-search-volume-history-2c6fbd76 -d '<json body>'
```

Example prompt: Can you pull the monthly Google search volume history back to 2019 for the keywords 'running shoes', 'trail running shoes', and 'minimalist running shoes' in the US so I can see their seasonality and demand trends?

## When to prefer this

Use this endpoint when you need longitudinal search volume data — seasonality analysis, year-over-year trends, or momentum tracking — rather than just a current snapshot. It's the right choice when a single keyword overview isn't enough and you need to understand how demand has evolved since 2019. Prefer this over Google Trends when you need absolute volume numbers alongside relative interest, or when you also need CPC and competition data in the same response.

## Known failure modes

- Unknown or very low-volume keywords are silently omitted from results
- Exceeding 10 keywords per call returns a validation error
- Invalid language code (not 2-letter) causes a 400 error
- Invalid location code returns an error or falls back to default
- Payment failure (insufficient USDC balance) blocks the call
- Very new keywords may have limited historical data prior to recent months

## Output

A per-keyword array containing a month-by-month search volume time series from 2019 to the present, along with the current cost-per-click (CPC) and competition score for each keyword. Keywords not recognized by the data source are omitted from the response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "keywords": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 80,
    "minLength": 1
   },
   "maxItems": 10,
   "minItems": 1,
   "description": "Keywords to look up (up to 10)."
  },
  "languageCode": {
   "type": "string",
   "pattern": "^[A-Za-z]{2}$",
   "description": "Language code (2-letter). Defaults to en."
  },
  "locationCode": {
   "type": "integer",
   "description": "DataForSEO location code. Defaults to 2840 (United States)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/keyword-monthly-search-volume-history-2c6fbd76/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)