# Keyword gap report (`seo.keyword_gap`)

Topics (free mode) or ranked keywords (licensed mode) a competitor covers that the site does not.

- **Route:** `POST /v1/run/seo.keyword_gap`
- **Price:** $0.25 per report ($250.00 per 1,000) · `cost_usd` on every response
- **Source:** First-party crawl (`site`) · failover: no
- **Measured latency:** not enough calls measured yet
- **Heavy response:** no

## Input

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `domain` | string | yes |  |  |
| `competitor` | string | yes |  |  |
| `location` | string | no | "us" |  |
| `language` | string | no | "en" |  |
| `limit` | integer | no | 25 |  |

## Output (`output` in the run envelope)

| Field | Meaning |
|---|---|
| `report_id` | Stable id of the stored report. |
| `method` | sitemap_topic_gap (free mode) or ranked_keywords (licensed mode). |
| `gaps` | Rows the competitor covers and the site does not, best first. |
| `section_gaps` | Free mode: whole site sections only the competitor has. |
| `sources` | Data sources used. |

## Example

```bash
curl -s -X POST https://getallapis.com/v1/run/seo.keyword_gap \
  -H "Authorization: Bearer $GETALLAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","competitor":"example.org","limit":10}'
```

```python
from getallapis_client import Client
client = Client()  # reads GETALLAPIS_API_KEY
result = client.run('seo.keyword_gap', {'domain': 'example.com', 'competitor': 'example.org', 'limit': 10})
print(result['cost_usd'], result['output'])
```

```bash
getallapis run seo.keyword_gap '{"domain":"example.com","competitor":"example.org","limit":10}'
```

Quote first (free, validates input): `POST /v1/quote/seo.keyword_gap` with the same body.
