AI Detector API Endpoint Reference

curl -X POST https://aidetectorapi.com/v1/detect \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "The quick brown fox jumps over the lazy dog. This sentence was generated by an AI model to demonstrate detection capabilities.",
    "language": "en"
  }'

{
  "score": 0.94,
  "label": "ai-generated",
  "sentences": [
    { "text": "The quick brown fox jumps over the lazy dog.", "score": 0.12 },
    { "text": "This sentence was generated by an AI model to demonstrate detection capabilities.", "score": 0.97 }
  ],
  "confidence": "high",
  "words_analyzed": 21
}

curl -X POST https://aidetectorapi.com/v1/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": [
      "First document to analyze...",
      "Second document to analyze...",
      "Third document to analyze..."
    ],
    "webhook_url": "https://yourapp.com/webhooks/ai-detect"
  }'

{
  "batch_id": "batch_abc123def456",
  "status": "processing",
  "count": 3
}

curl https://aidetectorapi.com/v1/usage \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "plan": "pro",
  "requests_used": 12847,
  "requests_limit": 50000,
  "period_start": "2026-02-01T00:00:00Z",
  "period_end": "2026-03-01T00:00:00Z"
}

{
  "event": "batch.completed",
  "batch_id": "batch_abc123def456",
  "results": [
    {
      "index": 0,
      "score": 0.94,
      "label": "ai-generated",
      "confidence": "high",
      "words_analyzed": 142
    },
    {
      "index": 1,
      "score": 0.07,
      "label": "human-written",
      "confidence": "high",
      "words_analyzed": 89
    }
  ],
  "completed_at": "2026-02-26T14:30:00Z"
}

import hmac
import hashlib

def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(),
        payload,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

{
  "error": "unauthorized",
  "message": "Invalid or missing API key. Include a valid Bearer token in the Authorization header."
}