CAPSOLVER
Blog
How to solve hCaptcha

How to solve hCaptcha

Logo of Capsolver

Ethan Collins

Pattern Recognition Specialist

19-Jun-2023

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 šŸ’œ

More

Best hCaptcha Solvers: Top Tools to Solve CAPTCHA in 2024
Best hCaptcha Solvers: Top Tools to Solve CAPTCHA in 2024

Stumbled upon a troublesome hCaptcha while web scraping? Learn how CapSolver quickly and accurately solves hCaptcha process and increases efficiency!

hCaptcha
Logo of Capsolver

Sora Fujimoto

13-Aug-2024

Solving hCaptcha in C++: A Complete Guide
Solving hCaptcha in C++: A Complete Guide

Learn how to solve hCaptcha in C++ using the CapSolver API. This complete guide covers setting up your project, creating tasks, and retrieving task results with practical examples.

hCaptcha
Logo of Capsolver

Sora Fujimoto

31-Jul-2024

How to Solve hCaptcha: A Comprehensive Guide
How to Solve hCaptcha: A Comprehensive Guide

hCaptcha is a robust CAPTCHA service that effectively differentiates between humans and bots, but it can pose challenges for legitimate automated processes

hCaptcha
Logo of Capsolver

Rajinder Singh

29-Jul-2024

How to solve captcha with playwright while web scraping
How to solve captcha with playwright while web scraping

Learn to seamlessly How to solve captcha with playwright while web scraping, a detailed guide on setting up and automating captcha solutions effectively

hCaptcha
Logo of Capsolver

Rajinder Singh

16-Jul-2024

Automating hCaptcha Solutions: Best Practices and Tools
Automating hCaptcha Solutions: Best Practices and Tools

Learn to seamlessly Automating hCaptcha Solutions: Best Practices and Tools, a detailed guide on setting up and automating captcha solutions effectively

hCaptcha
Logo of Capsolver

Ethan Collins

16-Jul-2024

How to Identify if hCaptcha is Enterprise | By using CapSolver Extension
How to Identify if hCaptcha is Enterprise | By using CapSolver Extension

Learn how to identify if hcaptcha is enterprise using the CapSolver extension. This guide provides step-by-step instructions for detecting hcaptcha parameters, ensuring you can manage and troubleshoot website security measures effectively.

hCaptcha
Logo of Capsolver

Ethan Collins

03-Jun-2024