hCaptcha Solve

10 credits

Solve a standard, non-Enterprise challenge and return a fresh token for the supplied sitekey and page URL.

POST/api/v1/tools/hcaptcha/solve

Parameters

sitekeystringrequired

The hCaptcha sitekey rendered by the target page.

urlstringrequired

Full URL where the token will be consumed. Its hostname is used while hCaptcha mints the token.

proxystring

Authenticated public HTTP proxy URL. Percent-encode reserved characters in credentials. When omitted, the managed hCaptcha proxy pool is used; direct egress is never used.

rqdatastring

Enterprise request data. Enterprise hCaptcha is not supported yet; requests containing rqdata return 422.

Response Schema

dataobject

Solver result

tokenstring

Fresh, single-use hCaptcha token. Pass it to the target flow immediately before it expires.

roundsnumber

Number of visual challenge rounds completed.

msnumber

Total solver time in milliseconds.

metaobject

Request and billing metadata

toolstring

Tool name (hcaptcha-solve)

creditsUsednumber

Credits consumed after a successful solve (10)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/hcaptcha/solve \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "sitekey": "10000000-ffff-ffff-ffff-000000000001",
    "url": "https://example.com/application"
  }'

Response Example

{
  "data": {
    "token": "P1_eyJ0eXAiOiJKV1QiLCJhbGciOi...redacted",
    "rounds": 2,
    "ms": 32104
  },
  "meta": {
    "tool": "hcaptcha-solve",
    "creditsUsed": 10,
    "requestId": "req_abc123"
  }
}