Check a page
Check a page on the brand's domain or a subdomain. Uses one monthly page check.
POST
/api/v1/brands/{brandId}/auditswriteCall the corresponding check_page MCP tool with JSON arguments. Supply brandId and other path values as named arguments when the endpoint has them.
Request details
Required scope: A valid write token.
Request example
curl --request POST \
--url "https://searchseal.com/api/v1/brands/b7e4c2a0-5d1f-4c8e-9a3b-2f6d8e1c4a70/audits" \
--header "Authorization: Bearer $SEARCHSEAL_TOKEN" \
--header "Content-Type: application/json" \
--data '{"url":"https://example.com/villas"}'Returns 201 for a new check. A repeat within one minute returns the same check with 200 and uses no extra checks.
Pages outside the brand domain return 400 invalid_request. At the monthly limit, 409 limit_reached includes auditsUsed and auditsMax.
Request parameters
| Name | Location | Required | Type | Description |
|---|---|---|---|---|
brandId | path | Yes | uuid | An active brand ID returned by the brand list. |
url | body | Yes | string | A page on the brand's domain or one of its subdomains. |
Response fields
Response body example
{
"id": "c4d7a2e9-1b5f-4a8c-9e3d-6f2b8a1c7d45",
"brandId": "b7e4c2a0-5d1f-4c8e-9a3b-2f6d8e1c4a70",
"url": "https://example.com/villas",
"status": "done",
"score": 70,
"checks": [
{
"id": "crawlers",
"label": "AI crawlers",
"state": "good",
"detail": "Google, Bing, ChatGPT search, Claude and Perplexity search bots allowed"
},
{
"id": "llms",
"label": "llms.txt",
"state": "missing",
"detail": "Not found"
},
{
"id": "schema",
"label": "Schema markup",
"state": "fix",
"detail": "Found Hotel. No Organization"
}
],
"fixes": [
{
"checkId": "schema_org",
"title": "Say who you are with Organization markup",
"impact": "Medium",
"why": "AI tools use it to connect this page to your company name, logo and profiles.",
"code": "<script type=\"application/ld+json\">…</script>",
"link": {
"href": "https://searchseal.com/tools/schema-generator",
"label": "Add logo and profiles in the schema generator"
}
}
],
"error": null,
"source": "api",
"createdAt": "2026-09-26T08:14:51.402Z",
"finishedAt": "2026-09-26T08:14:58.930Z",
"meta": {
"generatedAt": "2026-09-26T08:15:02.114Z",
"timeZone": "Asia/Jakarta"
}
}| Field | Type | Description |
|---|---|---|
id | uuid | Page check ID. |
url | string | The page that was checked. |
status | "running" | "done" | "failed" | Failed checks do not count toward your limit. See error for why the page could not be read. |
score | integer | null | Score from 0 to 100 once done. |
checks | object[] | Each check: { id, label, state, detail }. state: good, fix, missing or unknown (unreadable robots.txt, excluded from the score). |
fixes | object[] | What to change: { checkId, title, impact, why, code?, link? }. Failed checks also appear in the fix list. |
source | "dashboard" | "api" | "mcp" | Where the check was started. |
Successful REST responses from this endpoint include the shown meta fields. Read about data-through dates.
Possible errors
400 invalid_request— An input failed validation. Field details may appear inerrors.401 unauthorized— Authentication failed because the token is absent, unrecognized or revoked.403 forbidden— Account access or token permissions do not allow this request. Check the message for the cause.404 not_found— The resource is missing or unavailable to this account, including inactive brands.409 limit_reached— The account’s active-question capacity is exhausted.429 rate_limited— A quota was reached or could not be checked. Wait theRetry-Afterdelay before retrying.500 server_error— The server failed to complete the operation.
For the shared error format, see status codes, quotas and retries. Next endpoint: Get page check.