---
title: Pages
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/python)

[Speed](https://developers.cloudflare.com/api/python/resources/speed)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Pages

##### [List tested webpages](https://developers.cloudflare.com/api/python/resources/speed/subresources/pages/methods/list)

speed.pages.list(PageListParams\*\*kwargs) -> SyncSinglePage\[[PageListResponse](<https://developers.cloudflare.com/api/python/resources/speed#(resource)%20speed.pages%20%3E%20(model)%20page_list_response%20%3E%20(schema)>)]

GET/zones/{zone\_id}/speed\_api/pages

##### [List core web vital metrics trend](https://developers.cloudflare.com/api/python/resources/speed/subresources/pages/methods/trend)

speed.pages.trend(strurl, PageTrendParams\*\*kwargs) -> [Trend](<https://developers.cloudflare.com/api/python/resources/speed#(resource)%20speed%20%3E%20(model)%20trend%20%3E%20(schema)>)

GET/zones/{zone\_id}/speed\_api/pages/{url}/trend

##### ModelsExpand Collapse

<details>

<summary>

class PageListResponse: …

</summary>

region: Optional\[LabeledRegion]

A test region with a label.

<a href="#(resource)%20speed.pages%20%3E%20(model)%20page_list_response%20%3E%20(schema)%20%3E%20(property)%20region">Link to this property</a>

<details>

<summary>

schedule\_frequency: Optional\[Literal\["DAILY", "WEEKLY"]]

The frequency of the test.

</summary>

One of the following:

"DAILY"

<a href="#(resource)%20speed.pages%20%3E%20(model)%20page_list_response%20%3E%20(schema)%20%3E%20(property)%20scheduleFrequency%20%3E%20(member)%200">Link to this property</a>

"WEEKLY"

<a href="#(resource)%20speed.pages%20%3E%20(model)%20page_list_response%20%3E%20(schema)%20%3E%20(property)%20scheduleFrequency%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20speed.pages%20%3E%20(model)%20page_list_response%20%3E%20(schema)%20%3E%20(property)%20scheduleFrequency">Link to this property</a>

<details>

<summary>

tests: Optional\[List\[<a href="https://developers.cloudflare.com/api/python/resources/speed#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)">Test</a>]]

</summary>

id: Optional\[str]

UUID.

maxLength36

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

date: Optional\[datetime]

formatdate-time

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20date">Link to this property</a>

desktop\_report: Optional\[LighthouseReport]

The Lighthouse report.

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20desktopReport">Link to this property</a>

mobile\_report: Optional\[LighthouseReport]

The Lighthouse report.

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20mobileReport">Link to this property</a>

region: Optional\[LabeledRegion]

A test region with a label.

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20region">Link to this property</a>

<details>

<summary>

schedule\_frequency: Optional\[Literal\["DAILY", "WEEKLY"]]

The frequency of the test.

</summary>

One of the following:

"DAILY"

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20scheduleFrequency%20%3E%20(member)%200">Link to this property</a>

"WEEKLY"

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20scheduleFrequency%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20scheduleFrequency">Link to this property</a>

url: Optional\[str]

A URL.

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20url">Link to this property</a>

</details>

<a href="#(resource)%20speed.pages%20%3E%20(model)%20page_list_response%20%3E%20(schema)%20%3E%20(property)%20tests">Link to this property</a>

url: Optional\[str]

A URL.

<a href="#(resource)%20speed.pages%20%3E%20(model)%20page_list_response%20%3E%20(schema)%20%3E%20(property)%20url">Link to this property</a>

</details>

[Link to this property](<#(resource)%20speed.pages%20%3E%20(model)%20page_list_response%20%3E%20(schema)>)

#### PagesTests

##### [List page test history](https://developers.cloudflare.com/api/python/resources/speed/subresources/pages/subresources/tests/methods/list)

speed.pages.tests.list(strurl, TestListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[Test](<https://developers.cloudflare.com/api/python/resources/speed#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)>)]

GET/zones/{zone\_id}/speed\_api/pages/{url}/tests

##### [Get a page test result](https://developers.cloudflare.com/api/python/resources/speed/subresources/pages/subresources/tests/methods/get)

speed.pages.tests.get(strtest\_id, TestGetParams\*\*kwargs) -> [Test](<https://developers.cloudflare.com/api/python/resources/speed#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)>)

GET/zones/{zone\_id}/speed\_api/pages/{url}/tests/{test\_id}

##### [Start page test](https://developers.cloudflare.com/api/python/resources/speed/subresources/pages/subresources/tests/methods/create)

speed.pages.tests.create(strurl, TestCreateParams\*\*kwargs) -> [Test](<https://developers.cloudflare.com/api/python/resources/speed#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)>)

POST/zones/{zone\_id}/speed\_api/pages/{url}/tests

##### [Delete all page tests](https://developers.cloudflare.com/api/python/resources/speed/subresources/pages/subresources/tests/methods/delete)

speed.pages.tests.delete(strurl, TestDeleteParams\*\*kwargs) -> [TestDeleteResponse](<https://developers.cloudflare.com/api/python/resources/speed#(resource)%20speed.pages.tests%20%3E%20(model)%20test_delete_response%20%3E%20(schema)>)

DELETE/zones/{zone\_id}/speed\_api/pages/{url}/tests

##### ModelsExpand Collapse

<details>

<summary>

class Test: …

</summary>

id: Optional\[str]

UUID.

maxLength36

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

date: Optional\[datetime]

formatdate-time

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20date">Link to this property</a>

desktop\_report: Optional\[LighthouseReport]

The Lighthouse report.

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20desktopReport">Link to this property</a>

mobile\_report: Optional\[LighthouseReport]

The Lighthouse report.

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20mobileReport">Link to this property</a>

region: Optional\[LabeledRegion]

A test region with a label.

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20region">Link to this property</a>

<details>

<summary>

schedule\_frequency: Optional\[Literal\["DAILY", "WEEKLY"]]

The frequency of the test.

</summary>

One of the following:

"DAILY"

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20scheduleFrequency%20%3E%20(member)%200">Link to this property</a>

"WEEKLY"

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20scheduleFrequency%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20scheduleFrequency">Link to this property</a>

url: Optional\[str]

A URL.

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)%20%3E%20(property)%20url">Link to this property</a>

</details>

[Link to this property](<#(resource)%20speed.pages.tests%20%3E%20(model)%20test%20%3E%20(schema)>)

<details>

<summary>

class TestDeleteResponse: …

</summary>

count: Optional\[float]

Number of items affected.

<a href="#(resource)%20speed.pages.tests%20%3E%20(model)%20test_delete_response%20%3E%20(schema)%20%3E%20(property)%20count">Link to this property</a>

</details>

[Link to this property](<#(resource)%20speed.pages.tests%20%3E%20(model)%20test_delete_response%20%3E%20(schema)>)