🔌

Developer API

Integrate the Media Authenticity Detector into your products. Register for a free API key with 100 detections/month.

Get an API Key

Free tier: 100 detections/month. One key per email address.

Check Your Usage

API Reference

Base URL: /api

POST/api/detect

Analyze an image or video URL for authenticity. Pass your API key via the apiKey field for metered access, or omit for anonymous (session-based) usage.

REQUEST
POST /api/detect
Content-Type: application/json

{
  "url": "https://example.com/image.jpg",
  "apiKey": "mad_your_api_key_here"   // optional
}
RESPONSE
{
  "detectionId": "a1b2c3d4...",
  "url": "https://example.com/image.jpg",
  "mediaType": "image",
  "verdict": "AI",                      // AI | Real | CGI
  "confidence": 0.8712,                // 0.0 – 1.0
  "adRequired": false,                 // true for anonymous free users (every N uses)
  "_sig": "hmac_sha256_hex...",        // proprietary authenticity fingerprint
  "_ts": 1720000000000                 // Unix ms timestamp of detection
}
POST/api/keys

Register and receive an API key. The plaintext key is returned once — store it securely.

POST /api/keys
Content-Type: application/json

{ "name": "Jane Smith", "email": "jane@example.com" }

→ 201
{ "keyId": "...", "apiKey": "mad_...", "tier": "free", "usageLimit": 100 }
GET/api/keys/me
GET /api/keys/me
X-Api-Key: mad_your_api_key_here

→ 200
{ "usageCount": 12, "usageLimit": 100, "usageRemaining": 88, ... }
🔏 Proprietary Fingerprint (_sig)

Every detection response includes a _sig field: an HMAC-SHA256 signature over (detectionId + verdict + timestamp) using a server-held secret. This signature proves the response originated from our service and cannot be forged. If you're using our verdicts in a product, you can verify the signature against our public verification endpoint (coming soon) to prove authenticity to your users.

← Back to Detector