Phoenix Logo

Guide: How to use hCaptcha Solver

Learn how to automatically solve hCaptcha challenges - step by step

1

Create Task

First create a new solver task with your hCaptcha parameters.

1import requests
2import json
3
4url = "http://solver.phoenix-tools.xyz:5001/solve"
5
6params = {
7 "url": "https://example.com",
8 "sitekey": "a9b5fb07...",
9 "proxy": "user:pass@host:port"
10}
11
12response = requests.get(url, params=params)
13print(response.json())
14# Output: {"taskid": "cnhf4"}
Parameters:
β€’ url: The website URL where the captcha is located
β€’ sitekey: The hCaptcha sitekey of the website
β€’ rqdata: Optional RQData from the hCaptcha element
β€’ proxy: Optional proxy to solve through
2

Extract Task ID

The response contains a unique task ID with which you can retrieve the status.

1# Response example:
2{
3 "taskid": "cnhf4"
4}
5
6# Save task ID
7response_data = response.json()
8task_id = response_data['taskid']
9print(f"Task created: {task_id}")
3

Wait for Solution

Regularly check the status of the task until the solution is available.

1import time
2
3url = "http://solver.phoenix-tools.xyz:5001/task/cnhf4"
4
5for attempt in range(30):
6 response = requests.get(url)
7 data = response.json()
8
9 # Check if token is available
10 if 'token' in data and data['token']:
11 print("βœ“ Solved!", data['token'])
12 break
13 else:
14 print("⏳ Still solving...")
15 time.sleep(1)
Response Status:
β€’ status: "error": Task is still being solved
β€’ "token": "...": Solution available!
β€’ cookies: {}: Additional cookies

πŸš€ API Tester

Test the endpoint directly here and send demo requests:

Frequently Asked Questions

How long does it take to solve a captcha?

On average 30-40 seconds. The solution depends on the complexity and server load.

Can I use a proxy?

Yes! You can optionally specify a proxy via the 'proxy' parameter. Format: user:pass@host:port

Are there rate limits?

No, there are no rate limits. You can solve as many captchas as you want.

What happens if there are errors?

The status will be set to 'error'. You can then retry the task.

Is my code secure?

Yes, we don't store any data. Everything runs on-premise and is completely private.

Ready to get started?

Use hCaptcha Solver now for free!

Back to Product