# Keyword Ideas

> Keyword Ideas is a paid API for AI agents from agent.chiemgaufilms.com, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-28).

Returns up to 25 keyword suggestions containing the words of a seed phrase, with search volume, CPC, competition, and difficulty metrics.

## Facts

- Endpoint: POST https://agent.chiemgaufilms.com/api/v1/keyword-ideas?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/keyword-ideas-d835e99c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IFNqhX0Kdd--bzRp-X4UI

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-ideas-d835e99c -d '<json body>'
```

Example prompt: Give me up to 25 keyword ideas that contain the phrase 'running shoes' for the US market in English, along with their search volumes, CPC, competition levels, and keyword difficulty scores.

## When to prefer this

Choose this endpoint when you need keyword expansion ideas that all contain a specific seed phrase, combined with rich metrics (volume, CPC, competition, difficulty, intent) in a single call. Prefer it over a generic keyword metrics lookup when you want to discover new keyword variations rather than check known keywords, and over a site-based keyword endpoint when you are starting from a phrase rather than a domain. Best for SEO content planning and PPC keyword research at the seed phrase level.

## Known failure modes

- Unsupported country/language pair — request is refused before payment is charged
- Seed phrase exceeds 80 characters or 10 words — validation error
- Empty or missing keywords array — schema validation failure
- No keyword ideas found for an extremely niche seed phrase — empty ideas array returned
- Invalid location_code — error response with unrecognized location
- Invalid language_code format — pattern validation rejection

## How this service works

Up to 25 keyword suggestions containing the words of one seed phrase, with search volume, CPC and competition (DataForSEO Labs Keyword Suggestions). Use it to find new phrases around one seed; use keyword_metrics for exact volumes of keywords you already have and keyword_difficulty for ranking difficulty.

## Output

A JSON object containing: the seed keyword, location and language codes, total number of available keyword ideas, and an array of up to 25 keyword suggestions each with the keyword text, monthly search volume, CPC, numeric competition score (0-1), competition level label (LOW/MEDIUM/HIGH), keyword difficulty (0-100), main search intent, and low/high top-of-page bid estimates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "keywords": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 80,
    "minLength": 1
   },
   "maxItems": 1,
   "minItems": 1
  },
  "language_code": {
   "type": "string"
  },
  "location_code": {
   "type": "integer",
   "default": 2840,
   "maximum": 99999999,
   "minimum": 1000
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ideas": [
   {
    "cpc": 1.1,
    "keyword": "trail running shoes",
    "competition": 0.87,
    "main_intent": "commercial",
    "search_volume": 74000,
    "competition_level": "HIGH",
    "keyword_difficulty": 62,
    "low_top_of_page_bid": 0.45,
    "high_top_of_page_bid": 2.2
   }
  ],
  "language_code": "en",
  "location_code": 2840,
  "seed_keywords": [
   "running shoes"
  ],
  "total_available": 52000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/keyword-ideas-d835e99c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.chiemgaufilms.com](https://www.zero.xyz/host/agent.chiemgaufilms.com/llms.txt)