Скорость сайта
Метод API SerpWatch: Core Web Vitals во времени — данные реальных посетителей Chrome и замеры PageSpeed.
GET/api/v1/projects/{id}/vitals
Возвращает историю раздела «Скорость сайта»: p75 метрик LCP, INP, CLS, FCP и TTFB у реальных посетителей сайта (Chrome UX Report, скользящие 28 дней, смартфоны и компьютеры отдельно) с долями «хорошо», «нужно улучшить» и «плохо», текущие полевые данные по страницам и еженедельные замеры PageSpeed главной и важных страниц. Если у сайта мало посетителей из Chrome, field.*.has_data = false — есть только замеры PageSpeed. В поле competitors — те же данные посетителей Chrome по сайтам до 5 конкурентов (только Chrome UX Report, без PageSpeed), история по неделям.
Параметры
| Параметр | Где | Что значит |
|---|---|---|
id | в пути | id проекта |
Ответ
| Поле | Что значит |
|---|---|
enabled | включён ли еженедельный сбор |
origin | сайт, по которому берутся данные посетителей |
pages[] | страницы для замеров: главная и до 5 важных |
checked_at | последний сбор или null |
error | последняя ошибка сбора или null |
thresholds | пороги Google: [хорошо до, плохо после] |
field.phone, field.desktop | has_data, history[] — period_start, period_end, metrics (lcp, inp, cls, fcp, ttfb: p75, rating, good_pct, needs_improvement_pct, poor_pct) |
page_field[] | url, form, period_end, metrics — данные посетителей по странице |
lab[] | url, strategy (mobile, desktop), date, score, lcp_ms, cls, tbt_ms, fcp_ms, ttfb_ms, bytes, error |
events[] | date, kind (field, lab), text, notified — тревоги о замедлении |
competitors | auto (подобраны по снимкам выдачи или указаны вручную), domains[], checked_at, error, requests_per_week (min, max — запросов к Chrome UX Report в неделю), items[] — domain, origin, phone и desktop: has_data, history[] (period_start, period_end, metrics) |
{
"enabled": true,
"origin": "https://site.ru",
"pages": [
"https://site.ru/",
"https://site.ru/uslugi/"
],
"checked_at": "2026-10-12T04:20:11",
"error": null,
"thresholds": {
"lcp": [
2500,
4000
],
"inp": [
200,
500
],
"cls": [
0.1,
0.25
]
},
"field": {
"phone": {
"has_data": true,
"history": [
{
"period_start": "2026-09-14",
"period_end": "2026-10-11",
"metrics": {
"lcp": {
"p75": 2870,
"rating": "ni",
"good_pct": 68.2,
"needs_improvement_pct": 21.5,
"poor_pct": 10.3
}
}
}
]
},
"desktop": {
"has_data": false,
"history": []
}
},
"page_field": [],
"lab": [
{
"url": "https://site.ru/",
"strategy": "mobile",
"date": "2026-10-12",
"score": 64,
"lcp_ms": 3410.5,
"cls": 0.04,
"tbt_ms": 280.0,
"fcp_ms": 1620.0,
"ttfb_ms": 310.0,
"bytes": 1843200,
"error": null
}
],
"events": [
{
"date": "2026-10-12",
"kind": "lab",
"text": "Оценка PageSpeed (смартфон) site.ru/: 81 → 64",
"notified": true
}
],
"competitors": {
"auto": true,
"domains": [
"konkurent.ru"
],
"checked_at": "2026-10-12T04:21:40",
"error": null,
"requests_per_week": {
"min": 2,
"max": 4
},
"items": [
{
"domain": "konkurent.ru",
"origin": "https://www.konkurent.ru",
"phone": {
"has_data": true,
"history": [
{
"period_start": "2026-09-14",
"period_end": "2026-10-11",
"metrics": {
"lcp": {
"p75": 2140,
"rating": "good",
"good_pct": 79.4,
"needs_improvement_pct": 14.1,
"poor_pct": 6.5
}
}
}
]
},
"desktop": {
"has_data": false,
"history": []
}
}
]
}
}
Примеры
curl
curl -H "Authorization: Bearer sw_ваш_токен" \ "https://serpwatch.ru/api/v1/projects/12/vitals"
Python
import requests
r = requests.get("https://serpwatch.ru/api/v1/projects/12/vitals",
headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())
Ошибки
Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.
Для чего пригодится
- График скорости в своём дашборде
- Проверка, не замедлил ли сайт свежий релиз
- Сравнение скорости с конкурентами в отчёте клиенту