# citable.run Keyword Research

> citable.run Keyword Research is a paid API for AI agents from citable.run, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Returns keywords, related questions, and search volume metrics for a given seed keyword in a single API call.

## Facts

- Endpoint: GET https://citable.run/v1/keyword-research
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citable-run-keyword-research-87aaa5a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g2lhQgRR-2X1rGsifW2Zt

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 citable-run-keyword-research-87aaa5a1
```

Example prompt: Pull all the keywords and questions people search around the seed 'project management software' — English, US market, give me up to 150 results.

## When to prefer this

Choose this endpoint when you need keyword volume data, related keyword expansions, and People Also Ask-style questions all in a single call for a given seed term. It is ideal for SEO content planning, topic discovery, and international keyword research where you need both head terms and question variants with their search numbers. Prefer this over a full SERP scrape when you want structured keyword metrics rather than raw search result pages.

## Known failure modes

- Missing required 'seed' query parameter returns an error
- Seed keyword exceeding 80 characters is rejected
- Invalid language or country code may return no results or an error
- Limit value outside 1–200 range may be clamped or rejected
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Keywords, questions and their numbers for one seed, in a single call.

## Output

A list of keywords and related questions derived from the seed, each accompanied by search volume numbers and other metrics, returned in a single structured response. The result set size is controlled by the limit parameter (1–200 rows per list, default 100).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "seed"
     ],
     "properties": {
      "lang": {
       "type": "string",
       "description": "2-letter language code, default en"
      },
      "seed": {
       "type": "string",
       "description": "keyword to research (1–80 chars)"
      },
      "limit": {
       "type": "string",
       "description": "rows per list, 1–200 (default 100)"
      },
      "country": {
       "type": "string",
       "description": "2-letter country code, default us"
      }
     }
    }
   },
   "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/citable-run-keyword-research-87aaa5a1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from citable.run](https://www.zero.xyz/host/citable.run/llms.txt)