CorefinityCorefinityDocs
Open the Control PanelControl Panel
PageSpeed · 2 of 2

Start a PageSpeed test

Queues a mobile and a desktop test of the site's home page; read the history again for the results, which are in once the tests have left in_flight. A site can start two tests an hour, only while it is live, and Corefinity keeps a daily budget of tests for everyone.

POST/api/corestack/sites/{site}/pagespeed/runs

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.

Returns

202 Both tests are queued. Poll the operation until it finishes.

Fields of the 202 answer
runsarray of objectsRequired

The mobile test, then the desktop test, both queued. Up to 2 items.

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.

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.
409busyAnother operation is running on the site. Wait for it to finish.
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.
409preview_onlyThe environment has no domain attached yet. Attach one first.
409provisioningThe site is still being created. Try again in a few minutes.
409removedThe site or environment is being removed, or has been. Nothing can be changed on it.
422maintenanceThe site is in maintenance mode, which blocks this. Switch maintenance mode off first.
429rate_limitedWait for the seconds in Retry-After.
503switched_offCorefinity has switched this action off for the moment. Try again later.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl -X POST https://manage.corefinity.com/api/corestack/sites/1042/pagespeed/runs \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "runs": [
    {
      "created_at": "2026-11-10T13:00:00Z",
      "diagnostics": null,
      "error": null,
      "fetched_at": null,
      "field": null,
      "finished_at": null,
      "id": 6207,
      "lighthouse_version": null,
      "metrics": {
        "cls": {
          "band": null,
          "value": null
        },
        "fcp": {
          "band": null,
          "value_ms": null
        },
        "inp": {
          "band": null,
          "source": null,
          "value_ms": null
        },
        "lcp": {
          "band": null,
          "value_ms": null
        },
        "speed_index": {
          "band": null,
          "value_ms": null
        },
        "tbt": {
          "band": null,
          "value_ms": null
        },
        "ttfb": {
          "band": null,
          "value_ms": null
        }
      },
      "opportunities": [],
      "requested_by": {
        "id": 2042,
        "name": "Tom Harbour"
      },
      "score": {
        "band": null,
        "value": null
      },
      "started_at": null,
      "status": "queued",
      "status_label": "Queued",
      "strategy": "mobile",
      "url": "https://harbourandfinch.example.com/"
    },
    {
      "created_at": "2026-11-10T13:00:00Z",
      "diagnostics": null,
      "error": null,
      "fetched_at": null,
      "field": null,
      "finished_at": null,
      "id": 6208,
      "lighthouse_version": null,
      "metrics": {
        "cls": {
          "band": null,
          "value": null
        },
        "fcp": {
          "band": null,
          "value_ms": null
        },
        "inp": {
          "band": null,
          "source": null,
          "value_ms": null
        },
        "lcp": {
          "band": null,
          "value_ms": null
        },
        "speed_index": {
          "band": null,
          "value_ms": null
        },
        "tbt": {
          "band": null,
          "value_ms": null
        },
        "ttfb": {
          "band": null,
          "value_ms": null
        }
      },
      "opportunities": [],
      "requested_by": {
        "id": 2042,
        "name": "Tom Harbour"
      },
      "score": {
        "band": null,
        "value": null
      },
      "started_at": null,
      "status": "queued",
      "status_label": "Queued",
      "strategy": "desktop",
      "url": "https://harbourandfinch.example.com/"
    }
  ]
}
Try it

Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.

Was this helpful?
Open in ClaudeOpen in ChatGPT