API Documentation

Integrate with our API to access real-time threat intelligence data

Authentication

All API endpoints require authentication using your API key. Include your API key in the header of each request.

Authorization: your_api_key_here

Rate Limits

The API is limited to 1000 requests per day per API key. Contact us if you need a higher limit.

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 998
X-RateLimit-Reset: 86400

Endpoints

GET/api/reports/stats

Get Reports

{
  "domain": 100,
  "url": 200,
  "phone": 50,
  "ipAddress": 75,
  "ipNetwork": 20,
  "fileHash": 10
}

GET/api/reports/search

Search Reports

Query Parameters

{
  "query": "malicious.com",
  "type": "domain"
}

{
  "reports": [
    {
      "id": "clv1abcdef123456",
      "category": "Phishing",
      "createdAt": "2024-03-21T12:34:56.789Z",
      "comment": "Example comment",
      "evidence": "https://evidence-link.com",
      "domain": "malicious.com",
      "type": "domain"
    },
    {
      "id": "clv1abcdef654321",
      "category": "Malware",
      "createdAt": "2024-03-20T08:45:12.345Z",
      "comment": "Detected malware activity",
      "evidence": "https://another-evidence-link.com",
      "domain": "malicious.com",
      "type": "domain"
    }
  ]
}

POST/api/reports/submit

Submit Report

{
  "id": "clv1abcdef123456",
  "category": "bruteforce",
  "createdAt": "2024-06-11T12:34:56.789Z",
  "ipAddress": "192.168.1.100"
}