SEO Audit Status Endpoint
Returns current audit results and progress.
Endpoint
GET /wp-json/extrachill/v1/seo/audit/status
Authentication
Requires manage_network_options capability (Super Admin only).
Request Parameters
None.
Response
No Audit Data
{
"status": "none",
"timestamp": 0,
"progress": {},
"results": {
"missing_excerpts": { "total": 0, "by_site": {} },
"missing_alt_text": { "total": 0, "by_site": {} },
"missing_featured": { "total": 0, "by_site": {} },
"broken_images": { "total": 0, "by_site": {} },
"broken_internal_links": { "total": 0, "by_site": {} },
"broken_external_links": { "total": 0, "by_site": {} }
}
}
Complete Audit
{
"status": "complete",
"timestamp": 1703350800,
"progress": {},
"results": {
"missing_excerpts": {
"total": 47,
"by_site": {
"1": { "count": 12, "label": "Extra Chill" },
"2": { "count": 8, "label": "Community" }
}
}
}
}
In Progress
{
"status": "in_progress",
"timestamp": 1703350800,
"progress": {
"current_check_index": 3,
"checks": ["missing_excerpts", "missing_alt_text", "missing_featured", "broken_images", "broken_internal_links", "broken_external_links"],
"urls_checked": 150,
"urls_total": 500
},
"results": { ... }
}
Status Values
| Status | Description |
|---|---|
none |
No audit has been run |
in_progress |
Batch audit is running |
complete |
Last audit completed successfully |
Error Responses
403 Forbidden
{
"code": "rest_forbidden",
"message": "You do not have permission to run SEO audits.",
"data": { "status": 403 }
}
Related Endpoints
- POST /seo/audit – Start new audit
- POST /seo/audit/continue – Continue batch audit