# Keyword Gap

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

Returns up to 25 keywords a competitor ranks for in Google that your domain does not, ordered by search volume, with the competitor's ranking URL and difficulty metrics.

## Facts

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

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-gap-a4dc89dd -d '<json body>'
```

Example prompt: Show me the top keywords that competitor.com ranks for on Google in the US that my site example.com is missing — I want to find the highest-traffic gaps I should be targeting.

## When to prefer this

Use this endpoint when you need to identify specific keyword opportunities where a named competitor outranks your domain in Google organic search. It is ideal for competitive SEO strategy, content planning, and prioritizing new keywords by volume. Prefer this over general keyword discovery tools when you have a specific competitor to benchmark against and want actionable, ranked gaps rather than broad suggestions.

## Known failure modes

- Unsupported country/language combination returns an error before payment is charged
- Invalid domain format or IP address/port input is rejected
- Competitor domain with no ranking data returns an empty keywords array
- Invalid location_code or language_code format causes a validation error
- Either domain having no SEO footprint results in zero gap keywords
- DataForSEO upstream timeout or rate limit causes a 5xx error

## How this service works

Keywords a competitor ranks for in Google but your domain does not: up to 25, highest search volume first, with the competitor's ranking page (DataForSEO Labs Domain Intersection).

## Output

A JSON object containing up to 25 keyword gap opportunities, each with keyword text, monthly search volume, CPC, keyword difficulty score (0-100), competition level, the competitor's ranking position, and the specific competitor page URL that ranks. Also includes the domain and competitor names, language/location codes used, and the total number of available gap keywords beyond the 25 returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "domain": {
   "type": "string",
   "maxLength": 300
  },
  "competitor": {
   "type": "string",
   "maxLength": 300
  },
  "language_code": {
   "type": "string"
  },
  "location_code": {
   "type": "integer",
   "default": 2840,
   "maximum": 99999999,
   "minimum": 1000
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "domain": "example.com",
  "keywords": [
   {
    "cpc": 1.2,
    "keyword": "best running shoes",
    "search_volume": 49500,
    "competitor_url": "https://www.competitor.com/best-running-shoes",
    "competition_level": "HIGH",
    "keyword_difficulty": 68,
    "competitor_position": 4
   }
  ],
  "competitor": "competitor.com",
  "language_code": "en",
  "location_code": 2840,
  "total_available": 1204
 }
}
```

## More

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