SerpWatch
Меню

Скорость сайта

Метод 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.desktophas_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 — тревоги о замедлении
competitorsauto (подобраны по снимкам выдачи или указаны вручную), 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 запросов в минуту — в разделе ошибки и лимиты.

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

  • График скорости в своём дашборде
  • Проверка, не замедлил ли сайт свежий релиз
  • Сравнение скорости с конкурентами в отчёте клиенту