Сравнение аудитов
Метод API SerpWatch: что изменилось между двумя аудитами сайта — исправленные и новые проблемы, новые, пропавшие и изменившиеся страницы.
GET/api/v1/projects/{id}/audit/compare
Сравнивает два завершённых аудита проекта. Без параметров — два последних; только b — аудит b и тот, что был перед ним. Порядок не важен: более ранний аудит всегда «было» (a), более поздний — «стало» (b). Замечания сравниваются только на страницах, которые были в обоих обходах, — находки на новых страницах отдаются отдельно. Проверки, которых не было в версии старого аудита, помечены status: later и в новые проблемы не попадают. Если завершённых аудитов меньше двух, a и b — null.
Параметры
| Параметр | Где | Что значит |
|---|---|---|
id | в пути | id проекта |
a | необязательный | id аудита «было» |
b | необязательный | id аудита «стало» |
Ответ
| Поле | Что значит |
|---|---|
a, b | id, started_at, finished_at, pages, health (0–100), errors, warnings, notices, checks_version |
summary | fixed, appeared — замечаний исправлено и появилось; new_errors — новых ошибок; on_new_pages; new_pages, gone_pages, changed_pages, worse_changes; later_codes |
issues[] | code, title, severity, status (worse, mixed, better, same, later — проверка появилась позже, skipped — в новом аудите не проверялось), before, after — страниц было и стало; fixed[], appeared[], on_new_pages[], found[] — адреса (до 500); remained — сколько осталось |
pages.new[], pages.gone[] | url, status_code, depth, title, worse |
pages.changed[] | url, field (status_code, title, canonical, noindex, depth), before, after, worse — изменение к худшему |
{
"a": {
"id": 87,
"started_at": "2026-09-28T03:00:12",
"finished_at": "2026-09-28T03:09:40",
"pages": 212,
"health": 88,
"errors": 4,
"warnings": 31,
"notices": 40,
"checks_version": 7
},
"b": {
"id": 88,
"started_at": "2026-10-05T03:00:09",
"finished_at": "2026-10-05T03:12:40",
"pages": 214,
"health": 81,
"errors": 9,
"warnings": 30,
"notices": 41,
"checks_version": 7
},
"summary": {
"fixed": 3,
"appeared": 7,
"new_errors": 5,
"on_new_pages": 1,
"new_pages": 2,
"gone_pages": 0,
"changed_pages": 6,
"worse_changes": 5,
"later_codes": 0
},
"issues": [
{
"code": "http_error",
"title": "Страница отвечает ошибкой",
"severity": "error",
"status": "worse",
"before": 1,
"after": 4,
"fixed": [],
"appeared": [
"https://site.ru/catalog/shiny"
],
"remained": 1,
"on_new_pages": [],
"found": []
}
],
"pages": {
"new": [
{
"url": "https://site.ru/akcii",
"status_code": 200,
"depth": 1,
"title": "Акции",
"noindex": false,
"worse": false
}
],
"gone": [],
"changed": [
{
"url": "https://site.ru/uslugi",
"field": "noindex",
"before": false,
"after": true,
"worse": true
}
]
}
}
Примеры
curl
curl -H "Authorization: Bearer sw_ваш_токен" \ "https://serpwatch.ru/api/v1/projects/12/audit/compare"
Python
import requests
r = requests.get("https://serpwatch.ru/api/v1/projects/12/audit/compare",
headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())
Ошибки
Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.
Для чего пригодится
- Проверка сайта после релиза: что сломали разработчики
- Отчёт клиенту о том, что исправлено за месяц