Notice: Before sending recaptcha v2 task, you should transfer credits to recaptcha v2 type for consuming in guest system login in with your key.

ReCaptcha V2

ReCaptcha V2 is know as I'am not a robot. It contains two types, one is the checkbox and the other is invisible.


How to bypass


  1. Open the html source code of the target website.

  2. Find out script url such as

    or html block

  3. The google recaptcha key of the website is the render parameter or data-sitekey. Copy it. And send a Post http request with the value copies as parameter siteKey and full page URL as parameter pageUrl to our server api:

    . You can find the full list of parameters in the API List below.

  4. If the request is accepted fine, the server will return JSON {success: true, data: 12345} in which data is the id for the task you submit.

  5. Wait for 10-15 seconds to send a HTTP GET request to API

    providing the task ID. If task is solved the api will return the result in JSON. The result is a token like this:

    If the captcha is not solved yet the api will return finish=false in return JSON. Just repeat your request in 5-10 seconds.

  6. Find out the element with id g-recaptcha-response in target web page, or token is return in a callback function defined in data-callback parameter of reCaptcha, for example:

    Sometimes the callback function is defined as callback parameter of grecaptcha.render function, for example:

  7. You should find out how the target website use the token, and post the request with token returned by us.

  8. Congratulation! You will success to bypass. If you succeed to bypass, you can submit the result with 1 to us through the api

    If the token is valid cause you fail to bypass, please submit the result with 0 to us.


Invisible ReCaptcha is always located on a DIV layer positioned -10 000 px from top that makes it invisible for user.

ReCaptcha is activated on page load or on user's actions like click buttons or submit a form. If visitor's cookies are good enough then it will just pass automatically and no additional actions will be required. Otherwise user will see standard ReCaptcha.In most cases token is returned to a callback function.

Bypass steps are almost the same with checkbox one, the only difference is how you use the token.


API Return Value

Return value is JSON, including:

successbooleanTrue is success, false means failed
dataanyReturn data
messagestringError description contained when success is false
codestringError code contained when success is false


Error Code List

bypass.error.guest_key_not_existKey is invalid
bypass.error.guest_disabledKey is disabled
bypass.error.guest.credit_not_enoughNo enough credit
bypass.error.task.invalidTask id is invalid


API List

1. Post recaptcha task

keystringYesThe key you use to access bypasscaptcha apis
siteKeystringYesThe google recaptcha key of target website
pageUrlstringYesFull URL of the page where you want to bypass the ReCaptcha
invisiblenumberNoIf you use invisible recaptcha V2, please pass invisible = 1
vendorKeystringNoVendor key can be used in your software if your are a software vendor.

Return Value:

dataobjectTask Id


2. Check task status

keystringYesThe key you use to access bypasscaptcha apis
taskIdsstringYesTask ids join with ',' to be a string such as 1,2,3

Return Value:

dataArrayTask status list

Task Status Object:

finishbooleanIs task over
valuestringGoogle token
taskIdnumberIf task isn't over, taskId is 0
finishTimenumberUnix timestamp displayed as seconds. If task isn't over, finishTime is 0


3. Submit task result

keystringYesThe key you use to access bypasscaptcha apis
taskIdnumberYesThe task you want to report result
resultnumberYes1 means success, 0 means failure

Return Value: