Guides

Audit, then read the impact

Start from a registered and verified site (quickstart steps 1–3). Merge sitemap URLs, run the audit, read findings, check quota — each with its acceptance envelope.

Updated 2026-11-08

On this page

Audit, findings, quota

This page assumes your site is already registered and verified. On your first run, do the register and verify steps in the quickstart first — then come back to merge sitemap URLs, run the audit, read findings, and check quota. Set $API and $SEO_WATCH_KEY once (quickstart step 1).

  1. Merge sitemap URLs (optional)

    Quota-truncated: the response tells you how many URLs were kept.

    Shell
    curl -s -X POST "$API/v1/ai/sites/:id/import-sitemap" -H "Authorization: Bearer $SEO_WATCH_KEY"

    Expect: 200 · { imported, total, truncated }

  2. Trigger an audit

    Unverified sites get 403 SITE_NOT_VERIFIED and no job is created.

    Shell
    curl -s -X POST "$API/v1/ai/sites/:id/audits" -H "Authorization: Bearer $SEO_WATCH_KEY"

    Expect: 200 · audit summary (run id, counts by verdict)

  3. Read findings

    Paginate with limit (≤500) and offset; findings carry evidence keys.

    Shell
    curl -s "$API/v1/ai/audit-runs?siteId=:id" -H "Authorization: Bearer $SEO_WATCH_KEY"
curl -s "$API/v1/ai/audit-runs/:runId/findings?limit=100" -H "Authorization: Bearer $SEO_WATCH_KEY"

    Expect: 200 · runs list, then rule × page verdicts

  4. Check your quota

    Counts only — plan next audits against remaining.

    Shell
    curl -s "$API/v1/ai/quota" -H "Authorization: Bearer $SEO_WATCH_KEY"

    Expect: 200 · { audits: { used, limit, remaining }, api, alerts }