Skip to main content
POST
Preview a PageSpeed audit
Read-only. Takes the same body as POST /v3/page-speed/run (auditId, selection or targets/allPages, strategies, force) and returns eligibility ({ selected, eligible, skipped, byReason }) and units (eligible pages times strategies). Nothing is queued and no PageSpeed quota is used. Pages are skipped when they are already being tested, are still fresh, or fall outside the site’s audit scope.

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