Page audits
Get a page audit
Read one page audit by id, with each dimension's score, summary, recommendations and the checks behind the score.
HTTP
GET https://api.ranqo.ai/v1/brands/{brand_id}/page-audits/{audit_id}One audit with each dimension's checks.
Path parameters
| Name | Type | Description |
|---|---|---|
brand_id | string | The brand id, from GET /v1/brands. |
audit_id | string | The audit id, from GET /v1/brands/{brand_id}/page-audits. |
Response
One audit of one page, with every dimension's checks.
| Field | Type | Description |
|---|---|---|
id | string | |
url | string | |
title | string or null | |
status | string | One of pending, analyzing, completed, failed. |
page_type | string or null | What the page is, such as blog_article or product. |
page_score | integer or null | 0-100, the weighted score over the dimensions audited. Null until it completes. |
scores | object | Each 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. |
scores.crawlability | integer or null | 0-100; null when the dimension was not audited. |
scores.content_quality | integer or null | 0-100; null when the dimension was not audited. |
scores.page_speed | integer or null | 0-100; null when the dimension was not audited. |
scores.ai_readiness | integer or null | 0-100; null when the dimension was not audited. |
scores.citation_potential | integer or null | 0-100; null when the dimension was not audited. |
scores.authority_trust | integer or null | 0-100; null when the dimension was not audited. |
seo_score | integer or null | 0-100. |
geo_score | integer or null | 0-100, generative-engine optimization. |
word_count | integer or null | |
created_at | string | RFC 3339 timestamp in UTC. |
completed_at | string or null | RFC 3339 timestamp in UTC. |
error | string or null | Why the audit failed; null otherwise. |
meta_description | string or null | |
dimensions | array of objects | Each dimension audited, with the checks behind its score. |
dimensions[].id | string | One of crawlability, content_quality, page_speed, ai_readiness, citation_potential, authority_trust. |
dimensions[].label | string | |
dimensions[].score | integer | |
dimensions[].weight | number | Its share of the page score, 0-1: the shares of the dimensions audited sum to 1, as the score divides them. |
dimensions[].summary | string | |
dimensions[].recommendations | array of strings | |
dimensions[].signals | array of objects | |
dimensions[].signals[].id | string | |
dimensions[].signals[].label | string | |
dimensions[].signals[].status | string | One of pass, warning, fail. |
dimensions[].signals[].score | number | |
dimensions[].signals[].max_score | number | |
dimensions[].signals[].feedback | string |
Response headers
| Header | Description |
|---|---|
X-Request-Id | The request id; quote it to support. |
RateLimit | Requests left in this window and seconds until it resets. |
RateLimit-Policy | The key's limit per window. |
Example request
curl
curl "https://api.ranqo.ai/v1/brands/BRAND_ID/page-audits/AUDIT_ID" \
-H "Authorization: Bearer $RANQO_API_KEY"Errors
Errors are problem details (application/problem+json) with a stable code. See Errors for each one.