curl "https://app.ranked.ai/api/v1/projects/{projectId}/audits" \
-H "Authorization: Bearer rk_live_your_api_key"
{
"success": true,
"data": [
{
"id": "2e8b1269-d954-4b3b-a5e5-233bd44dfc28",
"target_url": "https://siouxcitytreeco.com/",
"status": "completed",
"crawl_progress": 100,
"pages_crawled": 34,
"total_issues": 0,
"critical_issues": 0,
"warning_issues": 0,
"notice_issues": 0,
"started_at": "2026-05-03T20:06:21.861+00:00",
"completed_at": "2026-05-03T21:04:36.6+00:00",
"created_at": "2026-05-03T20:06:21.998Z"
}
]
}
Audits
List Audits
List site audit tasks for a project
GET
/
projects
/
{projectId}
/
audits
curl "https://app.ranked.ai/api/v1/projects/{projectId}/audits" \
-H "Authorization: Bearer rk_live_your_api_key"
{
"success": true,
"data": [
{
"id": "2e8b1269-d954-4b3b-a5e5-233bd44dfc28",
"target_url": "https://siouxcitytreeco.com/",
"status": "completed",
"crawl_progress": 100,
"pages_crawled": 34,
"total_issues": 0,
"critical_issues": 0,
"warning_issues": 0,
"notice_issues": 0,
"started_at": "2026-05-03T20:06:21.861+00:00",
"completed_at": "2026-05-03T21:04:36.6+00:00",
"created_at": "2026-05-03T20:06:21.998Z"
}
]
}
Returns audit tasks ordered by most recent first.
Path parameters
string
required
Project UUID
Query parameters
number
default:"50"
Max audits to return
number
default:"0"
Number to skip
string
Filter by status:
pending, crawling, processing, completed, failedcurl "https://app.ranked.ai/api/v1/projects/{projectId}/audits" \
-H "Authorization: Bearer rk_live_your_api_key"
{
"success": true,
"data": [
{
"id": "2e8b1269-d954-4b3b-a5e5-233bd44dfc28",
"target_url": "https://siouxcitytreeco.com/",
"status": "completed",
"crawl_progress": 100,
"pages_crawled": 34,
"total_issues": 0,
"critical_issues": 0,
"warning_issues": 0,
"notice_issues": 0,
"started_at": "2026-05-03T20:06:21.861+00:00",
"completed_at": "2026-05-03T21:04:36.6+00:00",
"created_at": "2026-05-03T20:06:21.998Z"
}
]
}