# Keyword Difficulty Scorer

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

Returns SEO ranking difficulty scores (0–100) for up to 1000 keywords, indicating how hard it is to rank on Google page one

## Facts

- Endpoint: POST https://agent.connskill.com/v1/keyword-difficulty?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/keyword-difficulty-scorer-cf7789db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s6fwECyXUDPCgbSstyyK2

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-scorer-cf7789db -d '<json body>'
```

Example prompt: Can you check the ranking difficulty for these keywords in the US: 'best running shoes', 'cheap running shoes', 'trail running shoes for beginners', and 'minimalist running shoes'? I want to know which ones are realistically achievable to rank for on Google.

## When to prefer this

Choose this endpoint when you need bulk keyword difficulty scoring (up to 1000 at once) with location and language targeting. Prefer it over general SERP analysis when you need a fast, quantified difficulty score for content prioritization rather than full SERP breakdown. Ideal for keyword shortlisting workflows before investing in content creation.

## Known failure modes

- Exceeding the 1000-keyword limit per call results in an error
- Invalid or unsupported language_code or location_code may produce an error or fall back to defaults
- Empty or malformed keywords array returns a validation error
- Network timeout or service unavailability may return a 5xx error
- Payment failure (x402) results in a 402 Payment Required response

## How this service works

SEO ranking difficulty (0-100) for up to 1000 keywords — how hard it is to rank on Google page one

## Output

An object containing difficulty scores (0–100) for each submitted keyword, where higher values indicate more competitive SERPs and harder ranking on Google page one. Scores help prioritize keyword targeting by feasibility.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "keywords"
 ],
 "properties": {
  "keywords": {
   "type": "array",
   "description": "Keywords to score (max 1000). A single string is also accepted and treated as a one-element list."
  },
  "language_code": {
   "type": "string",
   "description": "ISO language code, defaults to en"
  },
  "location_code": {
   "type": "number",
   "description": "Location code (2840 = United States, 2276 = Germany)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "description": "SEO ranking difficulty (0-100) for up to 1000 keywords — how hard it is to rank on Google page one"
}
```

## More

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