Get started
API Reference

Documentation

Everything you need to integrate Black Eagle Solver into your application.

Open Swagger UIInteractive Tester

Authentication

Authenticate with API keys or JWT Bearer tokens.

Solve Captcha

POST /api/v1/captcha/solve – supports 8 captcha types.

API Keys

Create, list, suspend and delete API keys.

Statistics

Query usage stats by 24h / 7d / 30d period.

Base URL

https://api.blackeaglesolver.com/api/v1

All endpoints are relative to this base URL. Use HTTPS in production.

Authentication

Use either an X-API-Key header or a JWT Authorization: Bearer token.

# API Key (recommended for automation)
curl -H "X-API-Key: bes_your_api_key" https://api.blackeaglesolver.com/api/v1/captcha/solve

# Bearer Token
curl -H "Authorization: Bearer your_jwt_token" https://api.blackeaglesolver.com/api/v1/captcha/solve

Solve Captcha

POST/captcha/solve

Supported types: image_text, recaptcha_v2, recaptcha_v3, hcaptcha, funcaptcha, math, slider, rotate.

Image text example

curl -X POST https://api.blackeaglesolver.com/api/v1/captcha/solve \
  -H "X-API-Key: bes_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "captcha_type": "image_text",
    "image_base64": "<base64_encoded_image>"
  }'

reCAPTCHA v2 example

curl -X POST https://api.blackeaglesolver.com/api/v1/captcha/solve \
  -H "X-API-Key: bes_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "captcha_type": "recaptcha_v2",
    "site_key": "6Le...",
    "page_url": "https://example.com"
  }'

# Response
{
  "id": "abc123",
  "status": "success",
  "solution": "03AGdBq25...",
  "solve_time": 9.2,
  "captcha_type": "recaptcha_v2"
}

API Keys

GET/api-keysList all API keys
POST/api-keysCreate a new API key
DELETE/api-keys/{id}Delete an API key
PATCH/api-keys/{id}/suspendSuspend an API key
PATCH/api-keys/{id}/activateActivate a suspended key

Statistics

GET/stats/?period=24h|7d|30d
curl "https://api.blackeaglesolver.com/api/v1/stats/?period=7d" \
  -H "Authorization: Bearer your_jwt"

# Returns totals, per-hour usage, captcha type breakdown, heatmap data

Ready to integrate?

Create a free account and get 100 solves per month immediately.

Get Started Free