list_page_audits

list_page_audits returns the Page Audits (OptimizationReport rows) for a project, newest first, with status, audited URL, total modifications and GEO score (when complete). Use it to inspect what's already audited before triggering a new run with run_page_audit.

When to use

• Before queuing a new audit, to skip URLs already covered.
• After a batch run, to track which audits have transitioned to COMPLETED without polling each auditId individually.
• To build a diff view of audit history for a single page (filter the result client-side by pageUrl).

Input

Field	Type	Default	Description
projectId	string (CUID)	required	Project scope.
cursor	string	—	Cursor returned in pageInfo.nextCursor.
limit	int	20	Max items, 1–100.
status	enum	—	One of PENDING, GENERATING, COMPLETED, FAILED. Omit to return all.

Response

{
  "data": [
    {
      "id": "clx_rep_42",
      "pageUrl": "https://example.com/features/integrations",
      "pageTitle": "Native integrations — Example",
      "keyword": "Native integrations — Example",
      "status": "COMPLETED",
      "totalModifications": 12,
      "geoScore": 71,
      "createdAt": "2026-05-05T09:00:00.000Z",
      "updatedAt": "2026-05-05T09:01:13.000Z"
    }
  ],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 1 }
}

Field notes:

• totalModifications and geoScore come from the audit's summary blob and are null while the audit is in PENDING/GENERATING or has FAILED.
• status mirrors the OptimizationReport.status lifecycle. The terminal states are COMPLETED and FAILED.

Tips and patterns

• Pagination: cursor is the report's id. Stable across page boundaries.
• Pair with get_page_audit: this tool returns metadata only. To read the modifications array (the structured diff), call get_page_audit with the id.
• Status polling: rather than polling each pending audit individually, list with status=PENDING or status=GENERATING and walk the page.

Related tools

• get_page_audit — fetch a single audit (full report when COMPLETED).
• run_page_audit — queue a new audit.
• list_missed_citations — find URLs that should be audited but aren't yet.