API

REST API

Run scans from CI, your backend, or a Zapier workflow.

Endpoints

Start a scan

bash
curl -X POST https://magneticwp.com/api/public/scan \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://yoursite.com", "isPublic": true }'

Response shape

json
{
  "id": "sc_01HXYZ...",
  "status": "complete",
  "grade": "B",
  "score": 82,
  "dimensions": {
    "discoverability": 92,
    "content": 78,
    "bot_access": 80,
    "capabilities": 70
  },
  "checks": [
    { "id": "D1", "status": "pass", "weight": 6 },
    { "id": "B1", "status": "fail", "weight": 8, "detail": "GPTBot blocked" }
  ]
}