# true402 Keyword Ideas API

> true402 Keyword Ideas API is a paid API for AI agents from true402.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns keyword ideas with search volume, CPC, competition score, and search intent for a given seed keyword

## Facts

- Endpoint: POST https://true402.dev/api/v1/keyword-ideas
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/true402-keyword-ideas-api-0a0fbd9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oI1NPIcxkb5VfOZbtq6n0

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 true402-keyword-ideas-api-0a0fbd9e -d '<json body>'
```

Example prompt: Can you give me up to 100 keyword ideas based on the seed keyword 'coffee subscription', in English, so I can see which terms have the most search volume and lowest competition?

## When to prefer this

Choose this endpoint when you need keyword research data — search volume, CPC, competition, and intent — for a given seed keyword, especially in an automated agent workflow where pay-per-call pricing ($0.05 USDC) is preferable to a monthly SaaS subscription. It is well-suited for lightweight, on-demand SEO and PPC keyword expansion without requiring API key management, as wallet-based identity via x402 handles auth and billing in one step.

## Known failure modes

- Seed keyword not found in index: 'observed' field returns false with an empty ideas array
- Payment failure via HTTP 402: call rejected if wallet has insufficient USDC balance
- Seed keyword exceeds 80 characters: request validation error
- Limit parameter out of range (not 1-200): validation error returned
- Upstream index returns null search volumes: affected keywords omitted from response rather than shown as 0

## How this service works

The machine-native marketplace. Wallet = identity. Pay per call with HTTP 402.

## Output

A JSON object containing the original seed keyword, an array of keyword ideas each with keyword text, search volume (omitted if unmeasured upstream), CPC estimate, competition score (0-1), and search intent classification. Also includes language, location, the total number of ideas available in the index, the number returned, and an 'observed' flag indicating whether the index had any suggestions for this seed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "seed"
 ],
 "properties": {
  "seed": {
   "type": "string",
   "description": "Seed keyword, max 80 chars"
  },
  "limit": {
   "type": "integer",
   "description": "Ideas to return, 1-200, default 50"
  },
  "language": {
   "type": "string"
  },
  "location": {
   "type": "integer"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "seed": {
   "type": "string"
  },
  "ideas": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "cpc": {
      "type": "number"
     },
     "intent": {
      "type": "string"
     },
     "keyword": {
      "type": "string"
     },
     "competition": {
      "type": "number"
     },
     "searchVolume": {
      "type": "number",
      "description": "null upstream = unmeasured, omitted here rather than 0"
     }
    }
   }
  },
  "language": {
   "type": "string"
  },
  "location": {
   "type": "number"
  },
  "observed": {
   "type": "boolean",
   "description": "false when the index holds no suggestions for this seed"
  },
  "returned": {
   "type": "number"
  },
  "totalAvailable": {
   "type": "number",
   "description": "Total ideas the index has, before the limit was applied"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/true402-keyword-ideas-api-0a0fbd9e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from true402.dev](https://www.zero.xyz/host/true402.dev/llms.txt)