Audits auflisten
GET
/sites/{siteId}/audits- Berechtigung
sites:read- MCP-Tool
audit_status
List audits, the running one and budgets.
Die Beschreibungen kommen aus dem OpenAPI-Dokument und sind auf Englisch.
Parameter
| Name | Ort | Details |
|---|---|---|
siteIdPflicht | Pfad | stringWebsite id, from GET /sites. |
limit | Query | integerdefault 5, min 1, max 25Audits to return, 1 to 25. |
Antwort
200 · application/json
| Feld | Details |
|---|---|
audits | list of values · required; Full audits, newest first |
audits[].id | string |
audits[].kind | string |
audits[].status | string |
audits[].stage | string |
audits[].pagesCrawled | number |
audits[].pagesDiscovered | number |
audits[].pageBudget | number |
audits[].timeLimitMinutes | number |
audits[].cappedByPlan | true or false |
audits[].coverage | object |
audits[].coverage.sitemapUrls | number |
audits[].coverage.sitemapCrawled | number |
audits[].coverage.percent | number |
audits[].partialReason | |
audits[].issuesFound | number |
audits[].startedBy | string |
audits[].queuedAt | string |
audits[].startedAt | string |
audits[].finishedAt | string |
audits[].error | |
audits[].link | string |
active | required; The crawl queued or running now (an audit or a recheck); null when none |
nextScheduledAt | string or null · required; The next weekly audit (Sundays 02:00 UTC); null for a paused website |
pageBudget | object · required |
pageBudget.default | integer · required; Pages an audit gets without pageBudget |
pageBudget.planLimit | integer · required; The plan's pages per audit |
pageBudget.websiteSetting | integer · required; The website's own audit budget (Settings → Audit) |
apiStarts | object · required |
apiStarts.perDay | integer · required; Audits per website per 24 hours through the API and MCP |
apiStarts.usedToday | integer · required; Used in the last 24 hours |
apiStarts.left | integer · required; Left |
Fehler
| Status | Bedeutung |
|---|---|
401 | Missing, unknown or revoked key. Codes: missing_key, invalid_key. |
403 | The key lacks the scope, covers another website, or its owner lost access. Codes: missing_scope, other_site, owner_left, no_owner, forbidden. |
404 | Not found. Codes: not_found. |
429 | Too many requests this hour for this key. Codes: rate_limited. |
Beispielanfrage
curl \
-H "Authorization: Bearer mr_ws_…" \
"https://app.monoranks.com/api/v1/sites/SITE_ID/audits"const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/audits", {
headers: { Authorization: "Bearer mr_ws_…" },
});
if (!res.ok) throw new Error((await res.json()).error.message);
const data = await res.json();import requests
res = requests.get(
"https://app.monoranks.com/api/v1/sites/SITE_ID/audits",
headers={"Authorization": "Bearer mr_ws_…"},
)
res.raise_for_status()
data = res.json()<?php
$ch = curl_init("https://app.monoranks.com/api/v1/sites/SITE_ID/audits");
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => ["Authorization: Bearer mr_ws_…"],
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);import axios from "axios";
const { data } = await axios.get("https://app.monoranks.com/api/v1/sites/SITE_ID/audits", { headers: { Authorization: "Bearer mr_ws_…" } });Beispielantwort
{
"audits": [
{
"id": "d4f6a8c0-2e4a-4c6e-8a0c-4e6a8c0e2a4b",
"kind": "audit",
"status": "done",
"stage": "done",
"pagesCrawled": 412,
"pagesDiscovered": 418,
"pageBudget": 500,
"timeLimitMinutes": 30,
"cappedByPlan": false,
"coverage": {
"sitemapUrls": 398,
"sitemapCrawled": 391,
"percent": 98
},
"partialReason": null,
"issuesFound": 23,
"startedBy": "schedule",
"queuedAt": "2026-10-04T02:00:01.000Z",
"startedAt": "2026-10-04T02:00:04.000Z",
"finishedAt": "2026-10-04T02:41:12.000Z",
"error": null,
"link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/audit"
}
],
"active": null,
"nextScheduledAt": "2026-10-11T02:00:00.000Z",
"pageBudget": {
"default": 500,
"planLimit": 500,
"websiteSetting": 500
},
"apiStarts": {
"perDay": 3,
"usedToday": 1,
"left": 2
}
}{
"error": {
"code": "missing_key",
"message": "Send the key as Authorization: Bearer mr_site_…"
}
}{
"error": {
"code": "missing_scope",
"message": "This key does not have the scope this call needs."
}
}{
"error": {
"code": "not_found",
"message": "Website not found."
}
}{
"error": {
"code": "rate_limited",
"message": "More than 1200 requests this hour for this key."
}
}Der MCP-Server macht dasselbe mit dem Tool audit_status.