​
Service Details

  • Service ID: hcaptcha
  • Price: $0.0025 persolveper 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.