Developer API

Stable URL intelligence interfaces from day one.

Every endpoint returns structured JSON with scores, evidence arrays, recommendations, and limitation caveats. Authentication via API key header.

Authentication

Pass your API key in the Authorization header on every request. Keys are generated from your dashboard after signup.

Authorization: Bearer <your-api-key>

Endpoints

POST/api/v1/scans/url

Create an instant or deep URL scan.

Request body

Field	Type	Required	Description
`url`	string	yes	The target URL to scan, including protocol.
`mode`	string	no	"instant" (default) or "deep". Deep crawls up to 16 pages.
`types`	array	no	Scan types to run: ["cyber","ai","geo","quantum","blockchain"]. Defaults to all.

curl -X POST https://aiclicks.net/api/v1/scans/url \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com", "mode": "instant" }'

Response

{
  "id": "scan_01j9x...",
  "status": "complete",
  "url": "https://example.com",
  "mode": "instant",
  "created_at": "2026-05-22T10:14:03Z",
  "modules": {
    "cyber": { "score": 74, "grade": "B", "checks": [...] },
    "ai":    { "score": 31, "risk_level": "low", "signals": [...] },
    "geo":   { "score": 58, "signals": [...] }
  }
}

Rate limits

Plan	Requests / min	Requests / day	Notes
Free	10	30	No API key required for scan previews
Pro	60	1,000	Single API key per account
Business	300	10,000	Up to 5 keys, webhook support
Enterprise API	Custom	Custom	Dedicated rate limits, SLA