CorefinityCorefinityDocs
Open the Control PanelControl Panel
PageSpeed · 1 of 2

Get a site's PageSpeed history

Answers the Google PageSpeed Insights tests of the site's home page: the newest result for mobile and for desktop, the tests queued or running, every finished test of the last 30 or 90 days, and whether a test can be run now.

GET/api/corestack/sites/{site}/pagespeed

Path parameters

siteintegerRequired

The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.

Query parameters

rangestring

How far back the history and the series go. Defaults to 30d.

30d90d
strategystring

Keeps the history and the series of one strategy. Both when left out.

mobiledesktop

Returns

200 The history.

Fields of the 200 answer
enabledbooleanRequired

Whether PageSpeed tests are running at the moment.

historyarray of objectsRequired

The finished tests of the range, newest first.

Fields of each item
clsnumber or nullRequired
errorobject or any or nullRequired

Why a failed test failed. Null otherwise.

fcp_msinteger or nullRequired
fetched_atstring or nullRequired

When Google analysed the page, or when a failed test was tried. Format: date-time.

idintegerRequired

At least 1.

inp_msinteger or nullRequired
lcp_msinteger or nullRequired
performance_scoreinteger or nullRequired
requested_byobject or any or nullRequired

Who asked for the test. Null for a scheduled test.

speed_index_msinteger or nullRequired
statusstringRequired
queuedrunningsucceededfailed
strategystringRequired
mobiledesktop
tbt_msinteger or nullRequired
ttfb_msinteger or nullRequired
in_flightarray of objectsRequired

Tests queued or running now.

Fields of each item
created_atstring or nullRequired

Format: date-time.

diagnosticsobject or nullRequired

What the page loaded. Null when Google reports none of it.

Fields
dom_sizeinteger or nullRequired

The number of elements on the page.

resourcesarray of objectsRequired

The requests and bytes of each kind of file.

Fields of each item
requestsintegerRequired
transfer_bytesintegerRequired
typestringRequired

Google's name for the kind, such as script, image or font.

third_party_bytesinteger or nullRequired

The bytes loaded from other sites.

total_requestsinteger or nullRequired
total_transfer_bytesinteger or nullRequired
errorobject or any or nullRequired

Why a failed test failed. Null otherwise.

fetched_atstring or nullRequired

When Google analysed the page. Null until the test succeeds. Format: date-time.

fieldobject or nullRequired

Google's figures from real visits over the last 28 days. Null when it has none for the page or the site.

Fields
clsnumber or nullRequired
fcp_msinteger or nullRequired
inp_msinteger or nullRequired
lcp_msinteger or nullRequired
overallstring or nullRequired

Google's verdict in its own word, such as FAST, AVERAGE or SLOW.

sourcestringRequired

page when the figures are the tested page's; origin when any of them is for the whole site.

pageorigin
ttfb_msinteger or nullRequired
finished_atstring or nullRequired

Format: date-time.

idintegerRequired

At least 1.

lighthouse_versionstring or nullRequired
metricsobjectRequired
Fields
clsobjectRequired

Cumulative Layout Shift.

Fields
bandstring or nullRequired
goodneeds_improvementpoornull
valuenumber or nullRequired
fcpobjectRequired

First Contentful Paint.

Fields
bandstring or nullRequired
goodneeds_improvementpoornull
value_msinteger or nullRequired
inpobjectRequired

Interaction to Next Paint.

Fields
bandstring or nullRequired
goodneeds_improvementpoornull
sourcestring or nullRequired

field when the figure comes from real visits. Null when there is none.

value_msinteger or nullRequired
lcpobjectRequired

Largest Contentful Paint.

Fields
bandstring or nullRequired
goodneeds_improvementpoornull
value_msinteger or nullRequired
speed_indexobjectRequired

Speed Index.

Fields
bandstring or nullRequired
goodneeds_improvementpoornull
value_msinteger or nullRequired
tbtobjectRequired

Total Blocking Time.

Fields
bandstring or nullRequired
goodneeds_improvementpoornull
value_msinteger or nullRequired
ttfbobjectRequired

Time to first byte.

Fields
bandstring or nullRequired
goodneeds_improvementpoornull
value_msinteger or nullRequired
opportunitiesarray of objectsRequired

Google's suggestions with a saving, the largest saving first, ten at most. Up to 10 items.

Fields of each item
display_valuestring or nullRequired

The saving in Google's words, when it gives one.

idstringRequired

Google's name for the check, such as unused-javascript.

savings_msintegerRequired

The time the suggestion could save, in milliseconds.

titlestringRequired
requested_byobject or any or nullRequired

Who asked for the test. Null for a scheduled test.

scoreobjectRequired

The performance score, 0 to 100.

Fields
bandstring or nullRequired
goodneeds_improvementpoornull
valueinteger or nullRequired
started_atstring or nullRequired

Format: date-time.

statusstringRequired
queuedrunningsucceededfailed
status_labelstringRequired

The status as the Control Panel shows it, such as Queued or Done.

strategystringRequired
mobiledesktop
urlstringRequired

The address tested.

latestobjectRequired

The newest test that succeeded, for each strategy.

Fields
desktopobject or any or nullRequired
mobileobject or any or nullRequired
run_nowobjectRequired

Whether a test can be run now.

Fields
availablebooleanRequired
next_atstring or nullRequired

When the hourly limit next has room. Null when no test was run this hour. Format: date-time.

reasonstring or nullRequired

The sentence that says why not. Null when a test can be run.

remaining_this_hourintegerRequired

Tests you can still run now this hour.

seriesobjectRequired

The scores over the range, for a chart.

Fields
desktoparray of objectsRequired
Fields of each item
atstring or nullRequired

Format: date-time.

run_idintegerRequired

At least 1.

scoreintegerRequired
failuresarray of objectsRequired

The tests that failed in the range.

Fields of each item
atstring or nullRequired

Format: date-time.

errorstringRequired
run_idintegerRequired

At least 1.

strategystringRequired
mobiledesktop
fromstringRequired

Format: date-time.

mobilearray of objectsRequired
Fields of each item
atstring or nullRequired

Format: date-time.

run_idintegerRequired

At least 1.

scoreintegerRequired
rangestringRequired
30d90d
tostringRequired

Format: date-time.

siteobjectRequired
Fields
domainstringRequired
idintegerRequired

At least 1.

skippedobject or any or nullRequired

Why the site is not tested at the moment. Null when it is.

tested_urlstring or nullRequired

The address tests run against. Null while the site is not tested.

trendobjectRequired
Fields
desktopobjectRequired

The median score of the newest seven successful tests (current) against the seven before them (previous), and the difference (delta). current is null with fewer than three tests; previous and delta are null until the seven before also hold three.

Fields
currentinteger or nullRequired
deltainteger or nullRequired
previousinteger or nullRequired
mobileobjectRequired

The median score of the newest seven successful tests (current) against the seven before them (previous), and the difference (delta). current is null with fewer than three tests; previous and delta are null until the seven before also hold three.

Fields
currentinteger or nullRequired
deltainteger or nullRequired
previousinteger or nullRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409deletedThe site, environment or copy has been deleted, or is being deleted. Nothing can be changed on it. Restore a deleted site first if it can still be restored.
409provisioningThe site is still being created. Try again in a few minutes.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/corestack/sites/1042/pagespeed \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "enabled": true,
  "history": [
    {
      "cls": 0.04,
      "error": null,
      "fcp_ms": 1200,
      "fetched_at": "2026-11-09T13:00:00Z",
      "id": 6203,
      "inp_ms": 180,
      "lcp_ms": 2100,
      "performance_score": 91,
      "requested_by": null,
      "speed_index_ms": 2400,
      "status": "succeeded",
      "strategy": "desktop",
      "tbt_ms": 150,
      "ttfb_ms": 320
    },
    {
      "cls": 0.04,
      "error": null,
      "fcp_ms": 1200,
      "fetched_at": "2026-11-09T13:00:00Z",
      "id": 6202,
      "inp_ms": 180,
      "lcp_ms": 2100,
      "performance_score": 72,
      "requested_by": null,
      "speed_index_ms": 2400,
      "status": "succeeded",
      "strategy": "mobile",
      "tbt_ms": 150,
      "ttfb_ms": 320
    },
    {
      "cls": 0.04,
      "error": null,
      "fcp_ms": 1200,
      "fetched_at": "2026-11-02T13:00:00Z",
      "id": 6201,
      "inp_ms": 180,
      "lcp_ms": 2100,
      "performance_score": 64,
      "requested_by": null,
      "speed_index_ms": 2400,
      "status": "succeeded",
      "strategy": "mobile",
      "tbt_ms": 150,
      "ttfb_ms": 320
    }
  ],
  "in_flight": [],
  "latest": {
    "desktop": {
      "created_at": "2026-11-09T13:00:00Z",
      "diagnostics": null,
      "error": null,
      "fetched_at": "2026-11-09T13:00:00Z",
      "field": null,
      "finished_at": "2026-11-09T13:00:00Z",
      "id": 6203,
      "lighthouse_version": "12.6.0",
      "metrics": {
        "cls": {
          "band": "good",
          "value": 0.04
        },
        "fcp": {
          "band": "good",
          "value_ms": 1200
        },
        "inp": {
          "band": "good",
          "source": "field",
          "value_ms": 180
        },
        "lcp": {
          "band": "good",
          "value_ms": 2100
        },
        "speed_index": {
          "band": "good",
          "value_ms": 2400
        },
        "tbt": {
          "band": "good",
          "value_ms": 150
        },
        "ttfb": {
          "band": "good",
          "value_ms": 320
        }
      },
      "opportunities": [],
      "requested_by": null,
      "score": {
        "band": "good",
        "value": 91
      },
      "started_at": "2026-11-09T13:00:00Z",
      "status": "succeeded",
      "status_label": "Done",
      "strategy": "desktop",
      "url": "https://harbourandfinch.example.com/"
    },
    "mobile": {
      "created_at": "2026-11-09T13:00:00Z",
      "diagnostics": {
        "dom_size": 1290,
        "resources": [
          {
            "requests": 31,
            "transfer_bytes": 768400,
            "type": "script"
          },
          {
            "requests": 28,
            "transfer_bytes": 652100,
            "type": "image"
          }
        ],
        "third_party_bytes": 412600,
        "total_requests": 84,
        "total_transfer_bytes": 1843200
      },
      "error": null,
      "fetched_at": "2026-11-09T13:00:00Z",
      "field": {
        "cls": 0.05,
        "fcp_ms": 1400,
        "inp_ms": 180,
        "lcp_ms": 2300,
        "overall": "AVERAGE",
        "source": "page",
        "ttfb_ms": 700
      },
      "finished_at": "2026-11-09T13:00:00Z",
      "id": 6202,
      "lighthouse_version": "12.6.0",
      "metrics": {
        "cls": {
          "band": "good",
          "value": 0.04
        },
        "fcp": {
          "band": "good",
          "value_ms": 1200
        },
        "inp": {
          "band": "good",
          "source": "field",
          "value_ms": 180
        },
        "lcp": {
          "band": "good",
          "value_ms": 2100
        },
        "speed_index": {
          "band": "good",
          "value_ms": 2400
        },
        "tbt": {
          "band": "good",
          "value_ms": 150
        },
        "ttfb": {
          "band": "good",
          "value_ms": 320
        }
      },
      "opportunities": [
        {
          "display_value": "Est savings of 212 KiB",
          "id": "unused-javascript",
          "savings_ms": 450,
          "title": "Reduce unused JavaScript"
        },
        {
          "display_value": null,
          "id": "render-blocking-resources",
          "savings_ms": 300,
          "title": "Eliminate render-blocking resources"
        }
      ],
      "requested_by": null,
      "score": {
        "band": "needs_improvement",
        "value": 72
      },
      "started_at": "2026-11-09T13:00:00Z",
      "status": "succeeded",
      "status_label": "Done",
      "strategy": "mobile",
      "url": "https://harbourandfinch.example.com/"
    }
  },
  "run_now": {
    "available": true,
    "next_at": null,
    "reason": null,
    "remaining_this_hour": 2
  },
  "series": {
    "desktop": [
      {
        "at": "2026-11-09T13:00:00Z",
        "run_id": 6203,
        "score": 91
      }
    ],
    "failures": [],
    "from": "2026-10-11T13:00:00Z",
    "mobile": [
      {
        "at": "2026-11-09T13:00:00Z",
        "run_id": 6202,
        "score": 72
      },
      {
        "at": "2026-11-02T13:00:00Z",
        "run_id": 6201,
        "score": 64
      }
    ],
    "range": "30d",
    "to": "2026-11-10T13:00:00Z"
  },
  "site": {
    "domain": "harbourandfinch.example.com",
    "id": 1042,
    "skipped": null,
    "tested_url": "https://harbourandfinch.example.com/"
  },
  "trend": {
    "desktop": {
      "current": null,
      "delta": null,
      "previous": null
    },
    "mobile": {
      "current": null,
      "delta": null,
      "previous": null
    }
  }
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT