# SEO Keyword Difficulty Scorer

> SEO Keyword Difficulty Scorer is a paid API for AI agents from seo.openverbs.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-13).

Returns a 0-100 difficulty score indicating how hard it is to rank in Google's top 10 for up to 1000 keywords in a single call.

## Facts

- Endpoint: POST https://seo.openverbs.com/v1/keyword-difficulty
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seo-keyword-difficulty-scorer-69254aec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oD5vBdBgUwB8rw43v9_bQ

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 seo-keyword-difficulty-scorer-69254aec -d '<json body>'
```

Example prompt: Can you score the keyword difficulty for these keywords — 'project management software', 'free crm tool', and 'agile planning app' — so I can figure out which ones are actually worth targeting for our blog?

## When to prefer this

Use this endpoint when you have a list of candidate keywords and need to quickly assess competitive difficulty at scale (up to 1000 at once) before committing to content creation. It's ideal for filtering and prioritization workflows where you want to identify low-hanging fruit. Prefer this over full keyword metrics endpoints when difficulty score is the primary decision signal and you don't need search volume or CPC data.

## Known failure modes

- Keywords array is empty or exceeds 1000 items — validation error returned
- Invalid language code format (must be 2-letter ISO) — request rejected
- Invalid DataForSEO location code — may return empty results or error
- Keywords with no data in DataForSEO's index are silently omitted from results
- Payment failure due to insufficient USDC balance — 402 response before processing

## How this service works

Get the SEO keyword difficulty score (0-100, how hard it is to rank in Google top 10) for up to 1000 keywords in a single call. For prioritising which keywords to target. Keywords with no data are omitted.

## Output

A list of keywords with their corresponding difficulty scores (0-100), where 0 means very easy to rank and 100 means extremely competitive. Keywords with no available data are omitted from the response.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "keywords": {
       "type": "array",
       "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
       },
       "minItems": 1,
       "maxItems": 1000,
       "description": "Keywords to score (up to 1000)."
      },
      "locationCode": {
       "type": "integer",
       "description": "DataForSEO location code. Defaults to 2840 (United States)."
      },
      "languageCode": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Language code (2-letter). Defaults to en."
      }
     },
     "required": [
      "keywords"
     ],
     "additionalProperties": false
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seo-keyword-difficulty-scorer-69254aec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from seo.openverbs.com](https://www.zero.xyz/host/seo.openverbs.com/llms.txt)