Cloudflare API | Speed › Pages › Tests › get

API Reference

Account & User Management

Resource Sharing

AI

Certificate Management

Certificate Authorities

Client Certificates

Custom Certificates

Custom Hostnames

Keyless Certificates

MTLS Certificates

Origin CA Certificates

Origin Post Quantum Encryption

Origin TLS Client Auth

Cloudflare One

DNS

Account Custom Nameservers

Domain/Zone Management

IP Addresses

Media

Networking

Magic Cloud Networking

Magic Network Monitoring

Network Interconnects

Observability

Security Center

Radar

Routing & Performance

List tested webpages

List core web vital metrics trend

List page test history

Get a page test result

Start page test

Delete all page tests

Rules

Cloud Connector

Managed Transforms

URL Normalization

Security

Schema Validation

Content Scanning

Leaked Credential Checks

Token Validation

Storage & Databases

R2 Data Catalog

Threat Intelligence

Brand Protection

Workers & Pages

Browser Rendering

Durable Objects

Workers For Platforms

Shared

Speed

Speed

Domain types

LabeledRegion{…}

A test region with a label.

LighthouseReport{…}

The Lighthouse report.

Trend{…}

Availabilities

Speed.Availabilities

Methods

client.speed.availabilities.list(, ):

get/zones/{zone_id}/speed_api/availabilities

Retrieves quota for all plans, as well as the current zone quota.

Domain types

Availability{…}

Pages

Speed.Pages

Methods

client.speed.pages.list(, ):

<

PageListResponse

>

get/zones/{zone_id}/speed_api/pages

Lists all webpages which have been tested.

client.speed.pages.trend(, , ):

get/zones/{zone_id}/speed_api/pages/{url}/trend

Lists the core web vital metrics trend over time for a specific page.

Tests

Speed.Pages.Tests

Methods

client.speed.pages.tests.list(, , ):

V4PagePaginationArray

<

>

get/zones/{zone_id}/speed_api/pages/{url}/tests

Test history (list of tests) for a specific webpage.

client.speed.pages.tests.get(, , , ):

get/zones/{zone_id}/speed_api/pages/{url}/tests/{test_id}

Retrieves the result of a specific test.

Security

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example: Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

Zone Settings Write Zone Settings Read

Parameters

url: string

A URL.

testId: string

params:

zone_id: string

(maxLength: 32)

Identifier.

Returns

id?: string

(maxLength: 36)

UUID.

date?: string

(format: date-time)

desktopReport?:

LighthouseReport

The Lighthouse report.

mobileReport?:

LighthouseReport

The Lighthouse report.

region?:

A test region with a label.

scheduleFrequency?: "DAILY" | "WEEKLY"

The frequency of the test.

url?: string

A URL.

Request example

import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const test = await client.speed.pages.tests.get('example.com', 'test_id', {
  zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
});

console.log(test.id);

200Example

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
    "date": "2014-01-01T05:20:00.12345Z",
    "desktopReport": {
      "cls": 100,
      "deviceType": "DESKTOP",
      "error": {
        "code": "NOT_REACHABLE",
        "detail": "Details: net::ERR_CONNECTION_CLOSED",
        "finalDisplayedUrl": "example.com"
      },
      "fcp": 100,
      "jsonReportUrl": "jsonReportUrl",
      "lcp": 100,
      "performanceScore": 90,
      "si": 100,
      "state": "COMPLETE",
      "tbt": 100,
      "ttfb": 100,
      "tti": 100
    },
    "mobileReport": {
      "cls": 100,
      "deviceType": "DESKTOP",
      "error": {
        "code": "NOT_REACHABLE",
        "detail": "Details: net::ERR_CONNECTION_CLOSED",
        "finalDisplayedUrl": "example.com"
      },
      "fcp": 100,
      "jsonReportUrl": "jsonReportUrl",
      "lcp": 100,
      "performanceScore": 90,
      "si": 100,
      "state": "COMPLETE",
      "tbt": 100,
      "ttfb": 100,
      "tti": 100
    },
    "region": {
      "label": "Iowa, USA",
      "value": "us-central1"
    },
    "scheduleFrequency": "DAILY",
    "url": "example.com"
  }
}

client.speed.pages.tests.create(, , ):

post/zones/{zone_id}/speed_api/pages/{url}/tests

Starts a test for a specific webpage, in a specific region.

client.speed.pages.tests.delete(, , ):

TestDeleteResponse

delete/zones/{zone_id}/speed_api/pages/{url}/tests

Deletes all tests for a specific webpage from a specific region. Deleted tests are still counted as part of the quota.

Domain types

Test{…}

Schedule

Speed.ScheduleResource

Methods

client.speed.schedule.get(, , ):

get/zones/{zone_id}/speed_api/schedule/{url}

Retrieves the test schedule for a page in a specific region.

client.speed.schedule.create(, , ):

ScheduleCreateResponse

post/zones/{zone_id}/speed_api/schedule/{url}

Creates a scheduled test for a page.

client.speed.schedule.delete(, , ):

ScheduleDeleteResponse

delete/zones/{zone_id}/speed_api/schedule/{url}

Deletes a scheduled test for a page.

Domain types

Schedule{…}

The test schedule.