SerpWatch
Меню

Сравнение аудитов

Метод 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, bid, started_at, finished_at, pages, health (0–100), errors, warnings, notices, checks_version
summaryfixed, 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 запросов в минуту — в разделе ошибки и лимиты.

Для чего пригодится

  • Проверка сайта после релиза: что сломали разработчики
  • Отчёт клиенту о том, что исправлено за месяц