Content brief API
501 not_available before any charge.Outline, questions and gaps for one keyword. Needs a licensed keyword/SERP source.
Example
curl -s -X POST https://audit.45-94-66-237.sslip.io/v1/run/seo.content_brief \
-H "Authorization: Bearer $SITEAUDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword":"how to fix crawl errors"}'
from siteaudit_client import Client
client = Client() # reads SITEAUDIT_API_KEY
result = client.run('seo.content_brief', {'keyword': 'how to fix crawl errors'})
print(result['cost_usd'], result['output'])
const res = await fetch("https://audit.45-94-66-237.sslip.io/v1/run/seo.content_brief", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SITEAUDIT_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({"keyword": "how to fix crawl errors"}),
});
const run = await res.json();
console.log(run.cost_usd, run.output);
Sample response
In the free site mode this endpoint answers with this error before any charge. With a licensed source it returns the fields under Output.
{
"ok": false,
"request_id": "req_0c6d2f8e91a3b754",
"error": {
"code": "not_available",
"message": "Needs a licensed keyword/SERP data source; not available in free site mode.",
"retryable": false,
"billed": false
}
}
Cost at volume
You pay : $0.50 per report, no plan, nothing when idle. Failed calls are not charged.
Input
| Field | Type | Required | Default |
|---|---|---|---|
keyword | string | yes | |
location | string | no | "us" |
language | string | no | "en" |
Output
Inside output of 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. |
Data needed
A content brief needs search-result data for the keyword. It is only available when a licensed keyword/SERP source is configured on the server.
Measured performance
No calls measured on this server in the last 30 days yet, so there is no latency or success rate to show. Numbers appear here once real traffic exists; nothing is estimated.
Counted on this server, recomputed on every page view. Not a guarantee or an SLA.
Questions
How much does Content brief cost?
$0.50 per report, drawn from a prepaid USD wallet. The exact amount is on every response as cost_usd, and max_cost_usd lets you refuse anything higher.
Can I check the price before running?
Yes. POST /v1/quote/seo.content_brief with the same body validates the input and returns the price and whether your wallet can pay. It is free.
How reliable is it?
The numbers above are measured on this server's own calls over 30 days. There is one data source per mode and no automatic failover; failed calls are refunded.
Can an agent call it?
Yes, as the MCP tool run_endpoint with endpoint: "seo.content_brief", or through the CLI and SDKs.
Markdown version for agents: /docs/api/seo.content_brief.md
Run the full audit on your site. One call checks every item in the check reference and ranks the fixes.
Open the playground Endpoint details