Developer API

Integrate OnlineCorners scans into your own tools and workflows. Requires a PRO or AGENCY plan.

Authentication

All API requests require an API key passed in the X-Api-Key header. Generate API keys in your dashboard.

curl -X POST https://onlinecorners.com/api/v1/scan \
  -H "X-Api-Key: oc_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Rate Limits

PlanScans / DayAPI Keys
PRO1505
AGENCY1,00020

Endpoints

POST
/api/v1/scan
PRO+

Start a new website scan

Request body

{ "url": "https://example.com" }

Response

{ "success": true, "data": { "scanId": "clxxx...", "status": "PENDING" } }
GET
/api/v1/scan/:id
PRO+

Get scan results by ID

Response

{ "success": true, "data": { "id": "clxxx...", "status": "COMPLETE", "overallScore": 87, "securityScore": 90, "technicalScore": 85, "seoScore": 84, "toolResults": [...] } }

ToolResult Shape

{
  "slug": "ssl-checker",
  "label": "SSL Certificate",
  "status": "pass" | "fail" | "warn" | "info",
  "score": 0-100,
  "value": "string or object",
  "details": "explanation string",
  "fixSuggestion": "plain-English fix (on fail/warn only)",
  "durationMs": 142
}