Skip to main content
POST
Run a PageSpeed audit
Enqueue a Google PageSpeed Insights audit job in the background. Audits can target specific URLs, a table selection, or the entire site (allPages: true). Use POST /v3/page-speed/run-preview with the same body to see what would run first.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Body

application/json
auditId
string
required

SEO audit ID for this team's site.

teamId
string

SnowSEO team ID, as returned by list_teams.

selection
object
targets
object[]

Selected pages to audit.

strategies
enum<string>[]

Devices to test. Defaults to both.

Available options:
mobile,
desktop
allPages
boolean
default:false

Audit every page of the site. Expensive - this can consume a large share of the PageSpeed API key's quota.

force
boolean
default:false

Re-audit even if the stored result is still fresh.

Response

Default Response

eligibility
object
units
number
status
string
message
string
url
string
mobile
object | null
desktop
object | null
fetchedAt
string | null
mobileError
string | null
desktopError
string | null