Изображения
Метод 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_id | id аудита или null, если аудита не было |
collected | собраны ли изображения в этом аудите |
audit_finished_at | время окончания аудита |
summary | total, 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 и битых ссылок