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

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'])

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