How to Solve hCaptcha

Before we start solving hCaptcha, there are some requirements and points that we need to be aware of:

Requirements:

• Capsolver Key
• Proxy (Optional)

Points to be aware of:

• HCaptchaTaskProxyless is for sites that low score scenario.
• HCaptchaTask is for sites that require a low-medium score scenario.
• It's recommended to use the same proxy used to solve the captcha.
• It's recommended to use the same user-agent used to solve the captcha.

Capsolver offers various types of hCaptcha solves such as hCaptcha normal, hCaptcha invisible, and hCaptcha enterprise. Depending on the site, a different task type and different parameters may be required. The captcha token received can be verified by submitting it to the relevant site.

For solving hCaptcha, please use one of these task types:

• HCaptchaTaskProxyless: is using the server's built-in proxy
• HCaptchaTask: this task type requires your own proxies

You can find the documentation here: [link]

The first method that you need to use from the documentation is createTask. This method needs the parameters of the picture, some are required and some are optional, depending on the site that we want to use.

Step 1: Submitting the information to capsolver

Use the method createTask to submit the required information:

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
 "clientKey": "YOUR_API_KEY",
 "task": {
 "type": "HCaptchaTaskProxyless",
 "websiteURL": "",
 "websiteKey": ""
 }
}

After you submit the task to us, you should receive in the response a ‘Task id’ if it’s successful. Please read errorCode: full list of errors if you didn’t receive the task id.

Example response:

{
 "errorId": 0,
 "errorCode": "",
 "errorDescription": "",
 "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Step 2: Getting the results

To verify the results, you'll need to continuously poll the getTaskResult API endpoint until the captcha is resolved. Depending on the system load, you will get the results within the interval of 1s to 10s.

Example request:

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
{
 "clientKey": "YOUR_API_KEY",
 "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Example response:

{
 "errorId": 0,
 "errorCode": null,
 "errorDescription": null,
 "solution": {
 //userAgent used to solve the captcha
 "userAgent": "xxx",
 //expireTime of the token
 "expireTime": 1671615324290,
 "timestamp": 1671615024290,
 "captchaKey": "E0_xxx",
 //token of the captcha
 "gRecaptchaResponse": "3AHJ....."
 },
 "status": "ready"
}

⚠️ If the token is rejected, it may indicate that some information is missing or incorrect. We recommend thoroughly checking whether the hcaptcha is standard or enterprise and whether it requires additional parameters listed as optional in our documentation.

You can solve hCaptcha with any programming language such as: Node.JS, PHP, Python, C#, Typescript, GO.

Or you can integrate yourself using the documentation.

And that is how easily you can solve hCaptcha using the best captcha solving service.

Capsolver Team 💜