API Documentation

Complete guide to integrating Unbotify into your application

Getting Started

1. Create an Account

Sign up for an account at unbotify.com/signup

2. Generate an API Key

Visit your dashboard and create a new API key. Copy and store it securely.

3. Make Your First Request

Use your API key in the X-API-Key header to authenticate your requests.

Authentication

All API requests must be authenticated using either:

  • API Key - Include in the X-API-Key header
  • Bearer Token - Include in the Authorization header
X-API-Key: unbfy_your_api_key_here

Endpoints

POST/humanizer/humanize

Transform AI-generated text into natural, human-like writing through 11 sequential phases.

Request Body

{
  "text": "string (required)",
  "model": "string (optional, default: anthropic/claude-sonnet-4.5)",
  "mode": "string (optional, default: standard)"
}

Response

{
  "success": true,
  "result": "humanized text",
  "phaseResults": [
    {
      "phase": 1,
      "title": "Grammar Foundation",
      "changed": true,
      "inputLength": 100,
      "outputLength": 102,
      "output": "..."
    }
  ]
}
GET/humanizer/health

Check the health status of the humanizer service.

Response

{
  "status": "ok",
  "apiKeyConfigured": true
}

Code Examples

curl -X POST https://api.unbotify.ai/humanizer/humanize \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your AI-generated text here",
    "model": "anthropic/claude-sonnet-4.5",
    "mode": "standard"
  }'

Rate Limits

Rate limits are applied per API key. Contact support for increased limits.

Error Codes

CodeDescription
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing API key
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Service error

Need Help?

Check out our examples or contact support for assistance.