Developer

Public API

Integrate OMNIntel's URL scanning into your own apps. Free API with 30 requests/minute rate limit.

Generate API Key

Manage Key

Limits

30 requests / minute
No daily limit
1 key per email
Usage DashboardMonitor requests, response times, and scan analytics

Quick Start

1Generate your API key

Enter your email in the form on the left. Your key starts with wsk_

2Scan a URL
curl -X POST "https://omnintel.net/api/v1/scan" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"url": "example.com"}'
3Get results
{
  "url": "https://example.com",
  "domain": "example.com",
  "overall_score": 75,
  "status": "safe",
  "ssl_valid": true,
  "malware_detected": false,
  "phishing_detected": false,
  "threats_count": 2,
  "headers_score": 60,
  "content_score": 70,
  "reputation_score": 70,
  "category": "General Website",
  "category_tags": ["General Website"],
  "scan_duration_ms": 312,
  "scan_id": "abc-123-def"
}

Endpoints

POST
/api/v1/scan

Scan a URL for security threats. Returns score, status, SSL check, malware/phishing detection, category, and threat count.

Body: { "url": "example.com" }
GET
/api/v1/usage

Check your API key usage, rate limit remaining, and daily request count.

Webhooks

Receive real-time notifications when scans complete. Set your webhook URL, and we'll POST scan results to it automatically.

PUT
/api/developer/webhook

Set or update your webhook URL. Pass empty string to remove.

Body: { "webhook_url": "https://..." }

Webhook Payload

{
  "event": "scan.completed",
  "timestamp": "2025-01-01T00:00:00Z",
  "data": {
    "url": "https://example.com",
    "domain": "example.com",
    "overall_score": 75,
    "status": "safe",
    "ssl_valid": true,
    "threats_count": 2,
    "category": "General Website",
    "scan_id": "abc-123-def"
  }
}

Events: scan.completed, scan.test

Timeout: 10 seconds

Method: POST with JSON body

Header: User-Agent: OMNIntel-Webhook/1.0

Try it Live

Generate an API key first, then test it here.

Error Codes

401Missing or invalid API key
403API key has been revoked
429Rate limit exceeded (30/min)
400Invalid URL in request body