# citable.run Keyword Suggestions

> citable.run Keyword Suggestions is a paid API for AI agents from citable.run, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30).

Returns autocomplete expansions, related queries, and questions for a seed keyword, ranked across Google, YouTube, and Bing.

## Facts

- Endpoint: GET https://citable.run/v1/keyword-suggest?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citable-run-keyword-suggestions-8233aa65
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BWl1wMD42ICE1IzJ53mQz

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-suggestions-8233aa65
```

Example prompt: Give me keyword suggestions for the seed 'electric bikes' in English for the US market, pulling from Google, YouTube, and Bing with full a-z sweep depth.

## When to prefer this

Choose this endpoint when you need broad keyword discovery from actual search engine autocomplete data across multiple platforms simultaneously. It is ideal for content ideation, SEO planning, and competitive research where you want real user-generated query patterns rather than static keyword databases. Prefer it over single-engine alternatives when cross-platform coverage (Google + YouTube + Bing) matters, or when question-format and long-tail expansions are needed alongside standard autocomplete.

## Known failure modes

- Missing required 'seed' parameter returns a 400 error
- Seed exceeding 80 characters is rejected
- Unsupported language or country code may return empty results or an error
- Invalid source value in comma-list causes rejection
- Payment failure via x402 protocol blocks the request
- Rate limiting may return 429 if too many calls are made quickly

## How this service works

Keyword suggestions for a seed: autocomplete expansions, related queries, questions — ranked across Google, YouTube, Bing.

## Output

A ranked list of keyword suggestions for the given seed, organized into categories such as autocomplete expansions, related queries, and question formats, sourced from one or more of Google, YouTube, and Bing. Each suggestion reflects real user search behavior across the selected platforms.

## 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": "language code, default en (id supported with localized question words)"
      },
      "seed": {
       "type": "string",
       "description": "keyword to expand (1–80 chars)"
      },
      "depth": {
       "type": "string",
       "description": "0 seed only · 1 + questions and modifiers · 2 (default) + a–z sweep"
      },
      "limit": {
       "type": "string",
       "description": "max keywords per list, default 100, max 300"
      },
      "country": {
       "type": "string",
       "description": "country code, default us"
      },
      "sources": {
       "type": "string",
       "description": "comma list of google,youtube,bing (default all)"
      }
     }
    }
   },
   "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-suggestions-8233aa65/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)