Page audits
List page audits
List a brand's page audits, newest first, with each page's score and its score on every dimension audited.
/v1/brands/{brand_id}/page-auditsThe brand's page audits, newest first, as the Page Audit history lists them.
Authorization
AuthorizationstringheaderrequiredYour API key as Bearer ranqo_sk_…. The account owner creates keys in Settings, under API keys. See Authentication.
Path parameters
brand_idstringrequiredThe brand id, from GET /v1/brands.
Query parameters
Every parameter is optional. A parameter the endpoint does not take is refused with unknown_parameter.
limitintegerdefault: 50Items per page, 1 to 100.
Range: 1 ≤ x ≤ 100
cursorstringThe next_cursor of the previous page.
statusstringOnly audits in this state.
Options:pendinganalyzingcompletedfailed
curl "https://api.ranqo.ai/v1/brands/BRAND_ID/page-audits" \
-H "Authorization: Bearer $RANQO_API_KEY"Sample data from an invented brand. Try it shows your own.
Response
The response body, as JSON.
dataarray of objectsShow 13 fields insideHide the fields inside
idstringurlstringtitlestring or nullstatusstringOne of
pending,analyzing,completed,failed.page_typestring or nullWhat the page is, such as
blog_articleorproduct.page_scoreinteger or null0-100, the weighted score over the dimensions audited. Null until it completes.
scoresobjectEach dimension's 0-100 score. A page that served no text is scored on crawlability and page speed only; page speed is null when it could not be measured.
Show 6 fields insideHide the fields inside
crawlabilityinteger or null0-100; null when the dimension was not audited.
content_qualityinteger or null0-100; null when the dimension was not audited.
page_speedinteger or null0-100; null when the dimension was not audited.
ai_readinessinteger or null0-100; null when the dimension was not audited.
citation_potentialinteger or null0-100; null when the dimension was not audited.
authority_trustinteger or null0-100; null when the dimension was not audited.
seo_scoreinteger or null0-100.
geo_scoreinteger or null0-100, generative-engine optimization.
word_countinteger or nullcreated_atstringRFC 3339 timestamp in UTC.
completed_atstring or nullRFC 3339 timestamp in UTC.
errorstring or nullWhy the audit failed; null otherwise.
has_morebooleanWhether another page follows.
next_cursorstring or nullPass as
cursorfor the next page; null on the last page.
Response headers
X-Request-IdThe request id; quote it to support.
RateLimitRequests left in this window and seconds until it resets.
RateLimit-PolicyThe key's limit per window.
Errors
Errors are problem details (application/problem+json) with a stable code. See Errors for each one.