Как использовать API истории CrUX

Йоханнес Хенкель
Johannes Henkel
X GitHub Mastodon
Жасмин Ян
Jasmine Yan
GitHub
Барри Поллард

Опубликовано: 7 февраля 2023 г., Последнее обновление: 11 апреля 2025 г.

В этом руководстве представлен API-интерфейс Chrome UX Report (CrUX) History , который предоставляет временные ряды данных о производительности веб-сайтов. Эти данные обновляются еженедельно и позволяют просмотреть историю примерно за 6 месяцев, с 40 точками данных, расположенными с интервалом в одну неделю.

При использовании с ежедневными обновлениями из исходной конечной точки API CrUX теперь можно быстро увидеть как самые последние данные, так и события прошлых лет, что делает этот инструмент мощным средством для отслеживания изменений веб-страниц с течением времени.

Попробуйте API на этой странице.

Попробуйте!

Запрос к ежедневному API CrUX

Как уже говорилось в предыдущей статье об API CrUX , получить снимок данных поля для конкретного источника можно следующим образом:

API_KEY="[YOUR_API_KEY]"
curl "https://chromeuxreport.googleapis.com/v1/records:queryRecord?key=$API_KEY" --header 'Content-Type: application/json' --data '{"origin": "https://web.dev"}'

{
  "record": {
    "key": {
      "origin": "https://web.dev"
    },
    "metrics": {
      "largest_contentful_paint": {
        "histogram": [{
          "start": 0, "end": 2500, "density": 0.9192
        }, {
          "start": 2500, "end": 4000, "density": 0.0513
        }, {
          "start": 4000, "density": 0.0294
        }],
        "percentiles": {
          "p75": 1303
        }
      }
      // ...
    },
    "collectionPeriod": {
      "firstDate": { "year": 2022, "month": 12, "day": 27 },
      "lastDate": { "year": 2023, "month": 1, "day": 23 }
    }
  }
}

Данный снимок включает значения плотности гистограммы и значения процентилей за определенный 28-дневный период сбора данных, в данном случае, с 27 декабря 2022 года по 23 января 2023 года.

Запрос к API истории CrUX

Для вызова конечной точки истории измените queryRecord в URL на queryHistoryRecord в команде curl . Будет работать тот же ключ API CrUX, что и для предыдущего вызова. collectionPeriodCount указывает количество возвращаемых записей временного ряда; максимальное значение — 40. Если не указано, по умолчанию используется 25.

API_KEY="[YOUR_API_KEY]"
curl "https://chromeuxreport.googleapis.com/v1/records:queryHistoryRecord?key=$API_KEY" \
 --header