---
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

## Changes

- **2026-08-14** `c6b2fabd21be` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/page-speed/run/post.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snowseo/apis/snowseo-api/revisions/a63b6be50d97?raw)