# SEO audit (`seo.audit`)

Crawl a site within strict limits and return a scored, prioritized fix list with evidence URLs.

- **Route:** `POST /v1/run/seo.audit`
- **Price:** $1.00 per report ($1000.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:** yes — use `fields`, `max_items` or `summary`

## Input

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `domain` | string | yes |  |  |
| `competitors` | array | no |  |  |
| `location` | string | no | "us" |  |
| `language` | string | no | "en" |  |
| `focus` | string | no | "all" |  |

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

| Field | Meaning |
|---|---|
| `report_id` | Stable id of the stored report. |
| `summary` | Overall score, sub-scores and a one-paragraph diagnosis. |
| `actions` | Ranked fixes, each with impact, effort, evidence URLs and the finding it resolves. |
| `plan` | Actions grouped into now / next / later. |
| `technical_issues` | Crawl, indexing, on-page, content and speed findings. |
| `keyword_gaps` | Competitor topics or keywords the site lacks (data depends on mode). |
| `not_covered` | What this mode could not measure, instead of invented numbers. |
| `sources` | Every data source used, with what it contributed. |
| `partial` | True when a non-critical source failed; the report is still billed. |

## Example

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

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

```bash
getallapis run seo.audit '{"domain":"example.com","competitors":["example.org"]}'
```

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