API Reference

Detection API

REST API for integrating AI text detection into your applications. JSON in, JSON out, Bearer token authentication.

Overview

Base URL: https://api.poignantguide.net/v1

All requests require a Bearer token: Authorization: Bearer YOUR_API_KEY

Wondering who has the most accurate AI detector before you integrate one? Our benchmark compares 10 tools on 2,400 samples, and our AI detector buyer’s guide ranks them by use case.

POST /v1/detect/text

Request

POST /v1/detect/text
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "text": "Text to analyze...",
  "options": { "signals": true }
}

Response

{
  "ai_probability": 0.87,
  "classification": "ai",
  "confidence": "high",
  "word_count": 312,
  "signals": {
    "perplexity": 42.3,
    "burstiness": 0.18,
    "type_token_ratio": 0.61,
    "transition_phrase_density": 0.034
  },
  "processing_time_ms": 124
}

curl Example

curl -X POST https://api.poignantguide.net/v1/detect/text   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"text": "Your text here...", "options": {"signals": true}}'

Python Example

import requests
resp = requests.post(
    'https://api.poignantguide.net/v1/detect/text',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={'text': 'Your text here...', 'options': {'signals': True}}
)
print(resp.json()['ai_probability'])

Treat ai_probability as a signal, not proof: our humanizer bypass research found detector accuracy fell an average of 31 percentage points on humanized text.

Rate Limits

PlanReq/minReq/month
Developer1010,000
Professional60100,000
Enterprise600Unlimited

Error Codes

400  Bad Request: missing/invalid parameters
401  Unauthorized: invalid or missing API key
413  Payload Too Large: text exceeds 10,000 chars
422  Unprocessable: text too short (under 100 chars)
429  Too Many Requests: rate limit exceeded
500  Internal Server Error: retry after delay