# Content brief (`seo.content_brief`)

Outline, questions and gaps for one keyword. Needs a licensed keyword/SERP source.

> **Not available in this mode:** Needs a licensed keyword/SERP data source; not available in free site mode. Calls are refused with `501 not_available` and not charged.

- **Route:** `POST /v1/run/seo.content_brief`
- **Price:** $0.50 per report ($500.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 |
|---|---|---|---|---|
| `keyword` | string | yes |  |  |
| `location` | string | no | "us" |  |
| `language` | string | no | "en" |  |

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

| Field | Meaning |
|---|---|
| `report_id` | Stable id of the stored report. |
| `recommended_outline` | Suggested headings in order. |
| `questions` | Questions the page should answer. |
| `top_pages` | Currently ranking pages used as evidence. |
| `sources` | Data sources used. |

## Example

```bash
curl -s -X POST https://getallapis.com/v1/run/seo.content_brief \
  -H "Authorization: Bearer $GETALLAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"how to fix crawl errors"}'
```

```python
from getallapis_client import Client
client = Client()  # reads GETALLAPIS_API_KEY
result = client.run('seo.content_brief', {'keyword': 'how to fix crawl errors'})
print(result['cost_usd'], result['output'])
```

```bash
getallapis run seo.content_brief '{"keyword":"how to fix crawl errors"}'
```

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