hCaptcha

Solve standard and enterprise hCaptcha challenges with VastCap’s API

Service Details

• Service ID: hcaptcha
• Price: $0.0025 $per solve$ ($2.5 per 1000 solves) (subject to change very soon)
• Average Solve Time: 8 seconds
• Success Rate: 90-98%

Required Parameters

websiteURL · string · required

The URL of the page where the hCaptcha is located.

websiteKey · string · required

The site key of the hCaptcha from the target website.

proxy · string · required

Proxy in format login:password@ip_address:port. Required for accurate solving.

Optional Parameters

userAgent · string

The User-Agent header that will be used when solving the captcha. Must match the one used in your browser.

rqdata · string

The rqdata value from the hCaptcha challenge. Required for some implementations.

enterprise · boolean

Set to true for enterprise hCaptcha (Discord, Epic Games, TikTok, etc).

invisible · boolean

Set to true if the captcha is invisible (e.g., discord.com/register uses invisible captcha). More info: https://docs.hcaptcha.com/invisible/

Example Request - Standard hCaptcha

curl -X POST https://captcha.vast.sh/api/solver/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "HCaptchaTask",
      "websiteURL": "https://modrinth.com",
      "websiteKey": "4a7a2c80-68f2-4190-9d52-131c76e0c14e",
      "proxy": "user:pass@ip:port"
    }
  }'

Example Request - Enterprise hCaptcha

curl -X POST https://captcha.vast.sh/api/solver/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "HCaptchaTask",
      "websiteURL": "https://discord.com/register",
      "websiteKey": "a9b5fb07-92ff-493f-86fe-352a2803b3df",
      "proxy": "user:pass@ip:port",
      "rqdata": "...",
      "enterprise": true,
      "invisible": true
    }
  }'

Set enterprise: true for Discord, Epic Games, TikTok, and other enterprise sites. Discord Register, for example, uses invisible hcaptcha.

Solution Format

{
  "token": "P1_eyJ0eXAiOiJKV1..."
}

Integration Examples

Python

import requests
import time

# Create a task
task_data = {
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "HCaptchaTask",
        "websiteURL": "https://modrinth.com",
        "websiteKey": "4a7a2c80-68f2-4190-9d52-131c76e0c14e",
        "proxy": "user:pass@ip:port"
    }
}

response = requests.post(
    "https://captcha.vast.sh/api/solver/createTask", 
    json=task_data
)
task_id = response.json()["taskId"]

# Get the result
while True:
    result_data = {
        "clientKey": "YOUR_API_KEY",
        "taskId": task_id
    }
    result = requests.post(
        "https://captcha.vast.sh/api/solver/getTaskResult", 
        json=result_data
    ).json()
    
    if result.get("status") == "ready":
        # Use the token in your form submission
        hcaptcha_token = result["solution"]["token"]
        break
    
    time.sleep(3)  # Wait before trying again

Notes

• The solution token is typically valid for 2 minutes after being issued.
• For both standard and enterprise hCaptcha, use HCaptchaTask. Set enterprise: true for enterprise sites (Discord, Epic Games, TikTok, etc).
• Proxy usage is required for accurate solving.
• The old HCaptchaEnterpriseTask is deprecated. Use HCaptchaTask with the enterprise parameter instead.