SerpWatch
Меню

Изображения

Метод API SerpWatch: изображения сайта по последнему аудиту — вес, формат, битые, без alt, width/height и отложенной загрузки.

GET/api/v1/projects/{id}/images

Возвращает отчёт раздела «Изображения» из последнего завершённого аудита: все картинки, найденные на страницах, с числом страниц, где они встречаются, и проблемами. Самые частые изображения сайта проверяются запросом (не больше 300 за аудит): ответ сервера, вес и формат по Content-Type. Картинки с чужих сайтов запросом не проверяются — по ним есть только проблемы разметки. webp_saving_estimate — оценка: около 30% веса JPEG/PNG, у которых нет WebP- или AVIF-варианта. Если аудит сделан до появления раздела, collected = false — запустите аудит заново.

Параметры

ПараметрГдеЧто значит
idв путиid проекта

Ответ

ПолеЧто значит
audit_idid аудита или null, если аудита не было
collectedсобраны ли изображения в этом аудите
audit_finished_atвремя окончания аудита
summarytotal, checked, check_limit, stopped (limit, time или null), bytes — вес проверенных, webp_saving_estimate — байт, problems — число изображений по кодам проблем
images[]url, format (jpeg, png, webp, avif, svg… или null), status — HTTP-ответ или null, bytes, checked, problems[] — коды: img_broken, heavy_image, old_image_format, img_no_size, img_no_lazy, img_no_alt; pages_count, pages[] — до 5 страниц
{
  "audit_id": 52,
  "collected": true,
  "audit_finished_at": "2026-10-12T05:14:40",
  "summary": {
    "total": 148,
    "checked": 131,
    "check_limit": 300,
    "stopped": null,
    "bytes": 18874368,
    "webp_saving_estimate": 3984588,
    "problems": {
      "img_broken": 2,
      "heavy_image": 9,
      "old_image_format": 27,
      "img_no_size": 64,
      "img_no_lazy": 41,
      "img_no_alt": 18
    }
  },
  "images": [
    {
      "url": "https://site.ru/upload/hero.jpg",
      "format": "jpeg",
      "status": 200,
      "bytes": 1153433,
      "checked": true,
      "problems": [
        "heavy_image",
        "old_image_format",
        "img_no_size"
      ],
      "pages_count": 1,
      "pages": [
        "https://site.ru/"
      ]
    }
  ]
}

Примеры

curl

curl -H "Authorization: Bearer sw_ваш_токен" \
  "https://serpwatch.ru/api/v1/projects/12/images"

Python

import requests

r = requests.get("https://serpwatch.ru/api/v1/projects/12/images",
                 headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())

Ошибки

Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.

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

  • Список картинок на сжатие для верстальщика или контент-менеджера
  • Контроль после переезда на WebP: не осталось ли тяжёлых JPEG и битых ссылок