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.
HTTP
GET https://api.ranqo.ai/v1/brands/{brand_id}/page-auditsThe brand's page audits, newest first, as the Page Audit history lists them.
Path parameters
| Name | Type | Description |
|---|---|---|
brand_id | string | The brand id, from GET /v1/brands. |
Query parameters
Every parameter is optional. A parameter the endpoint does not take is refused with unknown_parameter.
| Name | Type | Default | Description |
|---|---|---|---|
limit | integer | 50 | Items per page, 1 to 100. |
cursor | string | The next_cursor of the previous page. | |
status | string | Only audits in this state. One of pending, analyzing, completed, failed. |
Response
The response body, as JSON.
| Field | Type | Description |
|---|---|---|
data | array of objects | |
data[].id | string | |
data[].url | string | |
data[].title | string or null | |
data[].status | string | One of pending, analyzing, completed, failed. |
data[].page_type | string or null | What the page is, such as blog_article or product. |
data[].page_score | integer or null | 0-100, the weighted score over the dimensions audited. Null until it completes. |
data[].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. |
data[].scores.crawlability | integer or null | 0-100; null when the dimension was not audited. |
data[].scores.content_quality | integer or null | 0-100; null when the dimension was not audited. |
data[].scores.page_speed | integer or null | 0-100; null when the dimension was not audited. |
data[].scores.ai_readiness | integer or null | 0-100; null when the dimension was not audited. |
data[].scores.citation_potential | integer or null | 0-100; null when the dimension was not audited. |
data[].scores.authority_trust | integer or null | 0-100; null when the dimension was not audited. |
data[].seo_score | integer or null | 0-100. |
data[].geo_score | integer or null | 0-100, generative-engine optimization. |
data[].word_count | integer or null | |
data[].created_at | string | RFC 3339 timestamp in UTC. |
data[].completed_at | string or null | RFC 3339 timestamp in UTC. |
data[].error | string or null | Why the audit failed; null otherwise. |
has_more | boolean | Whether another page follows. |
next_cursor | string or null | Pass as cursor for the next page; null on the last page. |
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" \
-H "Authorization: Bearer $RANQO_API_KEY"Errors
Errors are problem details (application/problem+json) with a stable code. See Errors for each one.