# x402-gateway: Keyword Volume

> x402-gateway: Keyword Volume is a paid API for AI agents from x402.freeq.one, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-17).

Returns Google search volume, CPC, and competition data for up to 100 keywords per call, paid per-use in USDC on Base via x402.

## Facts

- Endpoint: POST https://x402.freeq.one/tools/keyword_volume?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-gateway-keyword-volume-4ff23618
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SbVacWdNv2tcVQCF_9cAi

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 x402-gateway-keyword-volume-4ff23618 -d '<json body>'
```

Example prompt: Can you pull Google search volume, CPC, and competition data for these keywords: 'running shoes', 'protein powder', and 'yoga mat' — use English and the United States as the target location?

## When to prefer this

Choose this endpoint when you need keyword volume, CPC, and competition data without committing to a monthly SEO platform subscription. It is ideal for pay-per-use agent workflows, one-off research tasks, or automated pipelines where you want to enrich keyword lists on demand. Compared to full-service SEO APIs like DataForSEO or SEMrush, this is significantly cheaper per call at $0.03 USDC and requires no account setup — just a USDC wallet on Base.

## Known failure modes

- Exceeding 100 keywords per request returns a validation error
- Invalid language_code or location_code may return empty or incorrect results
- Keywords with very low search volume may return zero or null metrics
- Payment failure via x402 will block the request before processing
- Malformed input array (non-string items) causes a schema validation error

## How this service works

Keyword Volume: Google search volume, CPC, and competition for up to 100 keywords. Priced below typical SEO-data APIs. Pay per call in USDC on Base via x402 — POST https://x402.freeq.one/tools/keyword_volume.

## Output

A JSON object containing per-keyword metrics including monthly Google search volume, cost-per-click (CPC), and competition score for each keyword in the input list, scoped to the specified language and geographic location.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "keywords": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "example": [
    "running shoes",
    "protein powder"
   ],
   "maxItems": 100,
   "description": "Up to 100 keywords."
  },
  "language_code": {
   "type": "string",
   "description": "Language code (default 'en')"
  },
  "location_code": {
   "type": "integer",
   "description": "Google location code (default 2840 = United States)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-gateway-keyword-volume-4ff23618/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.freeq.one](https://www.zero.xyz/host/x402.freeq.one/llms.txt)