Browse all documentation

List page checks

List pages, most recently checked first, with the latest check, score history and open fixes.

GET/api/v1/brands/{brandId}/auditsread

Call the corresponding list_audits 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 read or write token.

Request example
curl --request GET \
  --url "https://searchseal.com/api/v1/brands/b7e4c2a0-5d1f-4c8e-9a3b-2f6d8e1c4a70/audits" \
  --header "Authorization: Bearer $SEARCHSEAL_TOKEN"

Request parameters

NameLocationRequiredTypeDescription
brandIdpathYesuuidAn active brand ID returned by the brand list.

Response fields

Response body example
{
  "items": [
    {
      "pageKey": "example.com/villas",
      "url": "https://example.com/villas",
      "latest": {
        "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"
      },
      "score": 70,
      "history": [
        {
          "id": "c4d7a2e9-1b5f-4a8c-9e3d-6f2b8a1c7d45",
          "score": 70,
          "checkedAt": "2026-09-26T08:14:58.930Z"
        }
      ],
      "openFixes": 2
    }
  ],
  "auditsUsed": 12,
  "auditsMax": 1000,
  "meta": {
    "generatedAt": "2026-09-26T08:15:02.114Z",
    "timeZone": "Asia/Jakarta"
  }
}
FieldTypeDescription
items[].urlstringThe page as last checked.
items[].latestobjectThe latest page check.
items[].scoreinteger | nullScore of the newest finished check.
items[].historyobject[]Finished checks, newest first, as { id, score, checkedAt }.
items[].openFixesintegerPage-check fixes still to do.
auditsUsedintegerPage checks used this month (UTC).
auditsMaxintegerPage checks included a month.

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 in errors.
  • 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.
  • 429 rate_limited — A quota was reached or could not be checked. Wait the Retry-After delay 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: Check a page.