Read audit pages
get_audit_pagesLists the pages a site audit crawled with status, fetch result (with the reason in failText when a page could not be loaded), title, size and link counts, plus Lighthouse scores for the pages it tested. Free: reads saved audit data. Lighthouse scores come from one lab test per device, not from real visitors, and INP is not measured, so Total Blocking Time stands in for it. Omit auditId for the audit Site Audit shows.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "get_audit_pages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Most pages to return (default 100). | |
| auditId | No | Audit ID. Leave it out to use the audit Site Audit opens: the newest completed audit of the project's own site that read at least one page (until one exists, the latest audit of any kind). | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| fetchClass | No | How the page read ended. "blocked" means bot protection challenged the crawler; "rate_limited" means a 429 stopped the read; "error" means the page could not be loaded, and failText says why. | |
| statusCode | No | Only pages with exactly this HTTP status. | |
| urlContains | No | Only pages whose URL contains this text. | |
| withLighthouse | No | Only pages that Lighthouse tested. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| pages | Yes | ||
| total | Yes |