Jak używać interfejsu CrUX History API

Johannes Henkel
Johannes Henkel
X GitHub Mastodon
Jasmine Yan
Jasmine Yan
GitHub
Barry Pollard

Opublikowano: 7 lutego 2023 r., ostatnia aktualizacja: 11 kwietnia 2025 r.

W tym przewodniku przedstawiamy punkt końcowy CrUX History API, który udostępnia szeregi czasowe danych o wydajności stron internetowych. Dane te są aktualizowane co tydzień i pozwalają wyświetlać historię z ostatnich 6 miesięcy z 40 punktami danych rozłożonymi w odstępach tygodniowych.

W połączeniu z codziennymi aktualizacjami z oryginalnego punktu końcowego CrUX API możesz teraz szybko zobaczyć zarówno najnowsze dane, jak i to, co wydarzyło się wcześniej. Dzięki temu jest to potężne narzędzie do śledzenia zmian na stronach internetowych w czasie.

Wypróbuj interfejs API na tej stronie

Wypróbuj

Wysyłanie zapytań do codziennego interfejsu CrUX API

Jak wspomnieliśmy w poprzednim artykule o CrUX API, możesz w ten sposób uzyskać migawkę danych z pola dla konkretnej domeny:

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 }
    }
  }
}

Ta migawka zawiera wartości gęstości histogramu i wartości percentyli dla konkretnego 28-dniowego okresu zbierania danych, w tym przypadku od 27 grudnia 2022 r. do 23 stycznia 2023 r.

Wysyłanie zapytań do CrUX History API

Aby wywołać punkt końcowy historii, zmień queryRecord w adresie URL na queryHistoryRecord w poleceniu curl. Możesz użyć tego samego klucza CrUX API co w poprzednim wywołaniu. collectionPeriodCount określa liczbę wpisów szeregów czasowych do zwrócenia. Maksymalna wartość to 40. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość 25.

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

Ogólny kształt odpowiedzi jest podobny, ale zawiera ona znacznie więcej danych. Zamiast pojedynczego punktu danych są teraz szeregi czasowe dla pól zawierających 75 percentyl (p75) i wartości gęstości histogramu.

{
  "record": {
    "key": {
      "origin": "https://web.dev"
    },
    "metrics": {
      "largest_contentful_paint": {
        "histogramTimeseries": [{
            "start": 0, "end": 2500, "densities": [
              0.9190, 0.9203, 0.9194, 0.9195, 0.9183, 0.9187
            ]
          }, {
            "start": 2500, "end": 4000