Starts a new SEO audit across the multisite network.

Endpoint

POST /wp-json/extrachill/v1/seo/audit

Authentication

Requires manage_network_options capability (Super Admin only).

Request Parameters

Modes

• full: Runs complete audit synchronously. May timeout on large networks.
• batch: Starts incremental audit. Use /seo/audit/continue to process remaining work.

Response

Full Mode (Complete)

{
    "status": "complete",
    "timestamp": 1703350800,
    "progress": {},
    "results": {
        "missing_excerpts": {
            "total": 47,
            "by_site": {
                "1": { "count": 12, "label": "Extra Chill" },
                "2": { "count": 8, "label": "Community" }
            }
        },
        "missing_alt_text": { ... },
        "missing_featured": { ... },
        "broken_images": { ... },
        "broken_internal_links": { ... },
        "broken_external_links": { ... }
    }
}

Batch Mode (In Progress)

{
    "status": "in_progress",
    "timestamp": 1703350800,
    "progress": {
        "current_check_index": 0,
        "sites": [1, 2, 3, 4, 5, 7, 8, 9, 10, 11],
        "checks": ["missing_excerpts", "missing_alt_text", ...],
        "urls_checked": 0,
        "urls_total": 0
    },
    "results": { ... }
}

Metrics Tracked

Error Responses

403 Forbidden

{
    "code": "rest_forbidden",
    "message": "You do not have permission to run SEO audits.",
    "data": { "status": 403 }
}

500 Dependency Missing

{
    "code": "dependency_missing",
    "message": "Extra Chill SEO plugin audit functions not available.",
    "data": { "status": 500 }
}

Related Endpoints

• GET /seo/audit/status – Get current audit results
• POST /seo/audit/continue – Continue batch audit