One-Time Site Audits
const url = 'https://sitechecker.pro/api/v1/one_time_audits?limit=50&offset=0';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://sitechecker.pro/api/v1/one_time_audits?limit=50&offset=0' \ --header 'Authorization: Bearer <token>'Returns the one-time site audit history for the account associated with the API key. Each record includes the audit date, website and crawl scope, page count, and project ID. Use the returned project ID with the existing Site Audit endpoints to retrieve the results of the selected audit. This endpoint reads existing audit records without starting a crawl or consuming one-time audit credits. Typical flow: list the history here, pick an audit, then pass its project_id to /api/v1/audit_summary, /api/v1/audit_issues, /api/v1/audit_pages, /api/v1/page_details or /api/v1/page_content.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Maximum number of audit records to return. Integer from 1 to 100; defaults to 50.
Number of audit records to skip. Non-negative integer; defaults to 0.
Responses
Section titled “Responses”Paginated one-time site audit history, newest first.
object
List of one-time site audit records for the current page.
object
Project ID of the one-time site audit. Use this ID with the existing Site Audit endpoints to retrieve the results of this audit.
Date and time of the audit, as recorded in the One-Time Site Audit history.
Audited website and crawl scope, as shown in the Website column, including subdomain and path scope notation.
Number of pages for this audit, as shown in the Pages column of the One-Time Site Audit history. null while the audit is still being crawled.
object
Total number of available audit records before pagination.
Page size applied to the response.
Pagination offset applied to the response.
Example
{ "data": [ { "project_id": 12345, "audit_date": "2026-11-12T08:30:00Z", "website": "https://*.example.com/blog*", "pages_count": 250 } ], "meta": { "total": 137, "limit": 50, "offset": 0 }}Missing or invalid API key
Returned as INVALID_API_KEY when the key is missing or unknown, and as REVOKED_API_KEY when the key exists but was revoked — the latter needs a new key.
object
object
Example
{ "error": { "code": "INVALID_API_KEY", "message": "Invalid or missing API key." }}No active API entitlement for the account
For endpoints that take no project_id. Returned as MISSING_PUBLIC_API_ACCESS when the account has no active API entitlement, and as ACCOUNT_BLOCKED or ACCOUNT_INACTIVE when the account behind a valid key is blocked or deactivated — a new key will not help, contact support@sitechecker.pro.
object
object
Example
{ "error": { "code": "MISSING_PUBLIC_API_ACCESS", "message": "API access is not available: the account has no active API entitlement." }}Invalid query parameters
Rejected query parameters. error.code is VALIDATION_ERROR for parameter validation (including a query parameter the endpoint does not accept), or INVALID_DATE_RANGE / INVALID_FILTER / INVALID_EVENT_TYPE / UNSUPPORTED_FILTER / UNSUPPORTED_DIMENSION / UNSUPPORTED_METRIC / UNSUPPORTED_SCOPE / SEGMENT_FILTER_UNSUPPORTED for module-specific rules. Request-body validation errors also carry error.details, listing every invalid field.
object
object
object
Every invalid field, not only the first one repeated in error.message. Present on request-body validation errors; field is the path inside the body.
object
Path of the invalid field inside the request body, e.g. url, keywords[0], geos[1].country_code.
Example
{ "error": { "code": "VALIDATION_ERROR", "message": "project_id is required." }}Rate limit exceeded — retry after the interval in the Retry-After header
object
object
Example
{ "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "Rate limit exceeded. Try again later." }}Internal server error
object
object
Example
{ "error": { "code": "INTERNAL_ERROR", "message": "Internal server error." }}