🤖HCaptcha

HCaptcha Solver Task (Requires your own proxies) & Required Parameters

Rest API Endpoint: https://captcha.datalabs.net/createTask

Creating The Task

POST https://captcha.datalabs.net/createTask
Host: captcha.datalabs.net
Content-Type: application/json

{
  "clientKey": "DATALABS_API_KEY",
  "task": {
    "type": "HCaptchaTask",
    "websiteURL": "https://accounts.hcaptcha.com/demo",
    "websiteKey": "a5f74b19-9e45-40e0-b45d-47ff91b7a6c2",
    "data":"custom_data", // Optional custom data
    "proxyType": "http",
    "proxyAddress": "1.1.1.1",
    "proxyPort": "9999",
    "proxyLogin": "username",
    "proxyPassword": "password",
    },
  "callbackUrl": "https://example.com/callback"
}

Task Parameter Table

ParametersRequiredDescription

type

true

HCaptchaTask

websiteURL

true

The website address in which you're solving the captcha for.

websiteKey

true

The websites static recaptcha sitekey. This can be found as the value of the attribute data-sitekey in the page source, and is commonly formatted as a GUID.

data

false

Custom data sent with custom implementations of hCaptcha, and typically coincides with an invisible captcha.

userAgent

false

Browser user-agent used in emulation. Must use modern browser user-agent to avoid google prompting to "Update your browser".

cookies

false

Cookies to be passed to the solver. Format: cookie1=value; cookie2=value2;

isInvisible

false

If the captcha field is visible set to true, if the captcha field is NOT visible or has a hidden field for confirmation this value must be set to false

proxyType

true

The type of proxy, accepts values: http, https, socks4, and socks5.

proxyAddress

true

The IPv4/IPv6 IP for your proxy (Host names, non-transparent, and local network proxies are not allowed)

proxyPort

true

The proxy port

proxyLogin

false

The proxy username

proxyPassword

false

The proxy password

Task Created Response

{
  "errorId":0,
  "taskId":997993082
}
ParametersDescription

errorId

0: Without error. 1: Error with request.

errorCode

Short code for error type.

errorDescription

More detailed description of the error that occurred.

taskId

Task ID, provided for synchronous tasks to be pushed to /getTaskResult

Retrieving the Solution

POST https://captcha.datalabs.net/getTaskResult
Host: captcha.datalabs.net
Content-Type: application/json

{
  "clientKey": "DATALABS_API_KEY",
  "taskId": "997993082"
}

Successful Solution Response

{
  "errorId":0,
  "status":"ready",
  "solution": {
    "gRecaptchaResponse": "P1_eyJ0eXAiOiJKV1Q...",
    "respKey": "E0_eyJ0eXAiOiJKV1QiLCJh...",
    "userAgent": "Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36"
  }
}
ParametersDescription

gRecaptchaResponse

The successfully solved solution token.

respKey

The result of window.hcaptcha.getRespKey(), some websites use this for additional verification.

userAgent

User agent used for the solution

Last updated