API Documentation

Complete API reference for integrating with the captcha solving platform. Supports PopularCaptchaTaskProxyless, PopularCaptchaTask (with proxy), optional rqdata (enterprise hCaptcha), pow_type (hsw/hsl), user_agent, and is_invisible (true for invisible captcha; worker uses small/hidden layout).

Create Task – Examples

Four ways to create a task: proxyless, proxyless with rqdata (enterprise), with proxy, with proxy + rqdata.

Proxyless

"task": {
  "type": "PopularCaptchaTaskProxyless",
  "websiteURL": "https://...",
  "websiteKey": "sitekey"
}

Proxyless + rqdata

"task": {
  "type": "PopularCaptchaTaskProxyless",
  "websiteURL": "https://...",
  "websiteKey": "sitekey",
  "rqdata": "enterprise-data"
}

With proxy

"task": {
  "type": "PopularCaptchaTask",
  "websiteURL": "https://...",
  "websiteKey": "sitekey",
  "proxy": "http://user:pass@host:port"
}

With proxy + rqdata

"task": {
  "type": "PopularCaptchaTask",
  "websiteURL": "https://...",
  "websiteKey": "sitekey",
  "proxy": "http://user:pass@host:port",
  "rqdata": "enterprise-data"
}

Optional: pow_type, user_agent, is_invisible

"task": {
  "type": "PopularCaptchaTaskProxyless",
  "websiteKey": "sitekey",
  "rqdata": "optional",
  "pow_type": "hsw",
  "user_agent": "Mozilla/5.0 ...",
  "is_invisible": false
}

pow_type: hsw (default) or hsl. user_agent: used when loading captcha (proxy flow). is_invisible: true for invisible captcha (e.g. Invisible reCAPTCHA); worker uses small/hidden layout.

Authentication

All API requests require authentication using your API key. Include it in the request body as clientKey.

POST

/api/createTask

{ "clientKey": "your-api-key", ... }

API Endpoints

POST/api/createTask

Create a new captcha solving task

POST/api/getTaskResult

Get the result of a captcha task

POST/api/getBalance

Get account balance

POST/api/reportTaskResult

Report task result (success/invalid)

Error Codes

400Invalid request or missing parameters

401Unauthorized - Invalid API key

402Insufficient balance or max pending reached

403Forbidden - Account banned or suspended

404Task not found

429Rate limit exceeded

503Service unavailable - Maintenance mode

Rate Limiting

API requests are rate-limited to prevent abuse. Default limits are configurable per API key. When rate limit is exceeded, you'll receive a 429 status code with an error message.