# Keyword Difficulty

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

Returns a keyword difficulty score (0–100) for up to 100 keywords, indicating how hard it is to rank organically in Google for each term.

## Facts

- Endpoint: POST https://agent.chiemgaufilms.com/api/v1/keyword-difficulty?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/keyword-difficulty-3e6b928f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bP5tc6LxknJ0S07hcbtwl

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-difficulty-3e6b928f -d '<json body>'
```

Example prompt: What are the keyword difficulty scores for 'project management software', 'crm tool', and 'team collaboration app' in the United States in English? I want to know which ones are easiest to rank for.

## When to prefer this

Use this endpoint when you need bulk keyword difficulty scores (up to 100 at once) for SEO strategy decisions, content prioritization, or competitive analysis. Prefer it over manual tools when automating keyword research workflows or comparing large keyword sets. It is backed by DataForSEO Labs data, making it reliable for country-level difficulty benchmarks across major markets like the US, UK, and Germany.

## Known failure modes

- Unsupported country/language pair — refused before payment with an error indicating the combination is not available
- Keywords exceeding 80 characters or 10 words per entry — rejected at input validation
- More than 100 keywords submitted — rejected due to batch size limit
- Invalid location_code or language_code format — schema validation error
- Keyword not indexed by DataForSEO — returned in the 'not_found' array with no score

## How this service works

Keyword difficulty score (0-100) for up to 100 keywords (DataForSEO Labs Bulk Keyword Difficulty).

## Output

Returns a JSON array where each entry contains the original keyword and its difficulty score from 0 (very easy) to 100 (extremely hard to rank), along with any keywords that were not found, and the language and location codes used for the lookup.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "keywords": [
   {
    "keyword": "running shoes",
    "keyword_difficulty": 71
   }
  ],
  "not_found": [],
  "language_code": "en",
  "location_code": 2840
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/keyword-difficulty-3e6b928f/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)