---
title: "Run a PageSpeed audit"
method: POST
path: "/v3/page-speed/run"
tags: ["PageSpeed"]
---

# Run a PageSpeed audit

`POST /v3/page-speed/run`

Measures pages with Google PageSpeed Insights and stores the results. SPENDS the team's PageSpeed quota — confirm with the user before running, especially with allPages, which audits the entire site. Runs in the background; poll the returned job. Omit both url and targets with allPages=true to re-audit everything.

## Request body

- object
  - `teamId` string — SnowSEO team ID. Call list_teams first to choose a team.
  - `auditId` string, required — SEO audit ID for this team's site.
  - `url` string — Single page URL to audit. Ignored when allPages is true.
  - `allPages` boolean — Audit every page of the site. Expensive — this can consume a large share of the team's PageSpeed quota.
  - `force` boolean — Re-audit even if the stored result is still fresh.

## Response `200`

Default Response

---

[API](https://skmtc.net/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.net/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/revisions/c8f1f876a92c/schema)