The API has three POST methods: createTask submits a captcha, getTaskResult returns the solution, getBalance shows the account balance. Every request is a JSON body with clientKey.

POST /createTask#

Creates a captcha-solving task and returns its taskId. The price of the task type is reserved on your balance and charged only if the task is solved.

Request

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV2TaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "6Le-xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

Response

{
  "errorId": 0,
  "taskId": 100
}

Supported task types. v1 supports token captchas, proxyless or with your own proxy:

RecaptchaV2TaskProxyless    // reCAPTCHA v2
RecaptchaV3TaskProxyless    // reCAPTCHA v3 (websiteKey + minScore, pageAction)
TurnstileTaskProxyless      // Cloudflare Turnstile
RecaptchaV2Task             // reCAPTCHA v2 (your proxy)
TurnstileTask               // Cloudflare Turnstile (your proxy)

Types without the Proxyless suffix are solved through your proxy and require proxyType (http, socks4 or socks5), proxyAddress and proxyPort. Optional: proxyLogin and proxyPassword (for proxies with authentication) and userAgent.

reCAPTCHA v2#

Types RecaptchaV2TaskProxyless and RecaptchaV2Task. Optional field: isInvisible (true for invisible reCAPTCHA). The solution key is gRecaptchaResponse.

Task object examples

// RecaptchaV2TaskProxyless
{
  "type": "RecaptchaV2TaskProxyless",
  "websiteURL": "https://example.com/login",
  "websiteKey": "6Le-xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "isInvisible": false
}

// RecaptchaV2Task (your proxy)
{
  "type": "RecaptchaV2Task",
  "websiteURL": "https://example.com/login",
  "websiteKey": "6Le-xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "proxyType": "http",
  "proxyAddress": "1.2.3.4",
  "proxyPort": 8080,
  "proxyLogin": "user",
  "proxyPassword": "password",
  "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) ..."
}

reCAPTCHA v3#

Type RecaptchaV3TaskProxyless. Required field: minScore (minimum acceptable score, e.g. 0.3); optional: pageAction. No proxy is needed for v3: tasks are solved from the service IPs. The solution key is gRecaptchaResponse.

Task object examples

// RecaptchaV3TaskProxyless
{
  "type": "RecaptchaV3TaskProxyless",
  "websiteURL": "https://example.com/login",
  "websiteKey": "6Le-xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "minScore": 0.3,
  "pageAction": "login"
}

Cloudflare Turnstile#

Types TurnstileTaskProxyless and TurnstileTask. No extra fields. The solution key is token.

Task object examples

// TurnstileTaskProxyless
{
  "type": "TurnstileTaskProxyless",
  "websiteURL": "https://example.com/login",
  "websiteKey": "0x4AAAAAAAxxxxxxxxxxxxxxxx"
}

// TurnstileTask (your proxy)
{
  "type": "TurnstileTask",
  "websiteURL": "https://example.com/login",
  "websiteKey": "0x4AAAAAAAxxxxxxxxxxxxxxxx",
  "proxyType": "http",
  "proxyAddress": "1.2.3.4",
  "proxyPort": 8080
}

POST /getTaskResult#

Returns the task status. While solving, status is processing; when done, status is ready and solution holds the token. If the captcha could not be solved, an error is returned and the reserved funds are refunded.

Request

{
  "clientKey": "YOUR_API_KEY",
  "taskId": 100
}

Response

{ "errorId": 0, "status": "processing" }

// reCAPTCHA v2 / v3
{
  "errorId": 0,
  "status": "ready",
  "solution": { "gRecaptchaResponse": "03AGdBq..." }
}

// Turnstile
{
  "errorId": 0,
  "status": "ready",
  "solution": { "token": "0.zxcv..." }
}

The solution key depends on the captcha type: gRecaptchaResponse for reCAPTCHA v2/v3, token for Turnstile.

POST /getBalance#

Returns the current available balance of your account.

Request

{ "clientKey": "YOUR_API_KEY" }

Response

{ "errorId": 0, "balance": 12.34 }