get_citation_check

io.github.AmauryDvl/serpmantics · Verify this server

Read an AI citation test, poll until it is done Returns the test started by `POST /api/v1/tools/citation-check`. While `status` is `pending` or `running`, call again every 3 seconds: each engine fills in as soon as it has answered. When `status` is `done`, at least one engine answered; `summary.citedBy` engines cite your domain out of `summary.enginesAnswered` engines that answered. When `status` is `failed`, `failureCode` says why (NO_ENGINE_ANSWERED, TIMEOUT, INTERNAL). Per engine: `cited` is true when a source of the answer is on your registrable domain or one of its subdomains, and `citedUrls` lists those pages; `mentioned` is true when your brand name appears in the answer text, which is NOT a citation. `status` no_answer means the engine showed no answer for this question (Google often shows no AI Overview), which is not a failure. No quota is consumed. The `checkId` is random: whoever holds it can read the test, which is what makes share links work. Tests expire after 30 days. Reads that are not attributed to an account are capped at 1000 per IP address and per UTC day, far above any legitimate polling: crossing it returns 429 READ_RATE_LIMITED with `Retry-After`.