reCAPTCHA Enterprise v3 API

By solvethree Updated

Get a reCAPTCHA v3 Enterprise token from your backend. Configure the site once, then send its hostname, action and a proxy. We'll return the token with the user agent and client hints to use when you submit it.

Try the API
On this page

Make the request

Set up an active site profile in your workspace before the first solve. Send the hostname in site and the page's actual reCAPTCHA action in action. Enterprise v3 is the default; use recaptchaType: v3 for standard v3. The task doesn't need a type, full page URL or site key.

Create the task with POST https://api.solvethree.com/v1/tasks. Authenticate with a workspace API key in the Authorization: Bearer header.

Task body · replace the example target and proxy
{
  "site": "example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example-recaptcha-001"
}

Submit the token

Read solution.token when the task is ready. Submit it in your application's CAPTCHA field through the same proxy, using the returned userAgent and secChUa. Solve close to the request that needs the token; don't build a cache of tokens for later.

A ready task means the solution was generated. Check the target's response to see whether it accepted the request.

Waiting and timeouts

Creation waits up to 15 seconds by default. Use ?waitMs=0 if you'd rather receive a task ID immediately and poll it.

Stop at ready or failed. If creation times out, reuse the original requestId with identical inputs to recover the task. A new ID can create another billable solve.

Price

$2.00 per 1,000 solves, paid from your workspace balance. Failed solves are refunded. Start with $5 in welcome credit; the minimum paid deposit is $10.