Coming soon

Token task · not live yet

reCAPTCHA v3 token API

Get invisible, score-based reCAPTCHA v3 tokens for any page action. Send the URL, site key and action name; submit the token with your request.

reCAPTCHA v3 is coming soon. It is not live yet: today POST /createTask with RecaptchaV3Task returns ERROR_TASK_NOT_SUPPORTED, and nothing is held or charged.

Planned price / 1,000
planned—
Status
Coming soon
Get notified See live types

Get notified and we will let you know when reCAPTCHA v3 tasks are accepted. The planned price may change at launch.

Planned interface

What is reCAPTCHA v3?

reCAPTCHA v3 runs in the background and never shows a challenge. Instead it scores each request and the site decides what to allow. The page asks for a token for a named action, such as login or submit, and sends it with the request. bypass.so will return that token.

When it launches, reCAPTCHA v3 will work like the other token types: createTask returns a taskId right away and you poll for the token. The fields below are the planned interface.

POST/createTask
GET/getTaskResult/{taskId}
POST/reportBad?task_id={taskId}
Not live yet. Until launch, createTask with RecaptchaV3Task returns the error shown below and nothing is charged. Get notified when it goes live.

Request parameters (planned)

FieldDescription
clientKeystringrequiredYour API key. You can also send it as Authorization: Bearer <key> instead.
typestringrequiredAlways RecaptchaV3Task for this task.
websiteURLstringrequiredFull URL of the page that requests the token.
websiteKeystringrequiredThe site key, usually the render= value in the script URL or the first argument of the execute call.
actionstringoptionalThe action name the page uses, for example login or submit. Match it exactly. Defaults to verify.
minScorenumberoptionalLowest score you want to aim for, such as 0.3, 0.7 or 0.9. Defaults to 0.3.
Planned request · POST /createTask






Today · POST /createTask


{
  "errorId": 1,
  "errorCode": "ERROR_TASK_NOT_SUPPORTED",
  "errorDescription": "reCAPTCHA v3 is coming soon"
}






Response fields (planned)


FieldMeaning


errorId0 on success, 1 on error. Errors also carry errorCode and errorDescription.


statusprocessing while the task runs, then ready or failed.


taskIdReturned by createTask. Use it to poll and to report a wrong answer.


solution.gRecaptchaResponseThe response token. Submit it in the g-recaptcha-response field.


solution.tokenFieldName of the form field the token belongs in, when it is known.


solution.tokenLifetimeSeconds the token stays usable after it is issued, when it is known.























Related types
Other task types

All types
















FAQ
reCAPTCHA v3 questions
More answers in the general FAQ.




Can I send reCAPTCHA v3 tasks today?
Not yet. Until launch, POST /createTask with RecaptchaV3Task returns errorId: 1 and ERROR_TASK_NOT_SUPPORTED. No credit is held or charged.


What will it cost?
The planned price is — per 1,000 solved tasks. As with every type, you will pay only for solved tasks. We will confirm the final price at launch.


How will I know when it launches?
Use the Get notified form and we will let you know once reCAPTCHA v3 tasks are accepted.


What can I use today?
Math, image to text, audio, reCAPTCHA v2 and Cloudflare Turnstile are live now, with the same key and endpoints. See all task types.


What is the action parameter?
reCAPTCHA v3 tokens are tied to a named action chosen by the page, such as login or checkout. Find it in the execute call and send the same string in action.


Where do I find the site key?
In the script URL as render=<key>, or as the first argument of the execute call in the page code.








Want reCAPTCHA v3 when it launches?
Get notified and we will tell you as soon as reCAPTCHA v3 tasks are accepted. Until then, everything else works with the same key.


Get notifiedSee live types