# Google reCAPTCHA V3

For reCAPTCHA Enterprise, please refer to reCAPTCHA V2 API Documentation.

reCAPTCHA Token API consumes 20 credits per POST request.

Puzzle challenges presented by reCAPTCHA V2 and V3 are indistiguishable. However, the method of extracting tokens is different, so please correctly identify the reCAPTCHA version you wish to solve. Details on how to do this are outlined below.

reCAPTCHA V2 Widget looks like the following:

If you see this widget on the webpage you wish to bypass, please refer to reCAPTCHA V2 API Documentation. This page is for the invisible version (V3) of reCAPTCHA.

Our methods of generating reCAPTCHA V3 tokens returns a human score between 0.3 to 0.9. Currently, you cannot specify a minimum score token; however, our generated tokens will work on most sites.

# Submit the CAPTCHA to NopeCHA

POST https://api.nopecha.com/token/

Parameter	Type	Required	Description
key	String	Required	NopeCHA subscription key.
type	String	Required	`recaptcha3`
sitekey	String	Required	reCAPTCHA data-sitekey.
url	String	Required	URL where the reCAPTCHA is found.
enterprise	Boolean	Optional	`true` if reCAPTCHA is an enterprise version.
data	Dict	Optional	Extra parameters used to solve the challenge. See data.* parameters below.
data.action	String	Optional	The value of the `data-action` attribute of the reCAPTCHA element if it exists.
proxy	Dict	Optional	The proxy used to solve the challenge. See using proxies for formatting guide.
cookie	Array of Dict	Optional	Cookies used to solve the challenge. See using cookies for formatting guide.
useragent	String	Optional	The user-agent used to solve the challenge. A user-agent of a modern browser is required.

POST https://api.nopecha.com/token/

{
    'key': 'MY_NOPECHA_KEY',
    'type': 'recaptcha3',
    'sitekey': '6LfZRA8jAAAAAPDv_kHq_QhvdDKkB90dtTheEMAu',
    'url': 'https://nopecha.com/demo/recaptcha#v3',
    'data': {
        'action': 'check'
    }
}

Retrieve solution with the data value

{
    'data': 'PHN2ZyB3aWR0aD0'
}

# Get the token from NopeCHA

GET https://api.nopecha.com/token/

Parameter	Type	Required	Value
key	String		NopeCHA subscription key.
id	String		The value of `data` from POST response.

GET https://api.nopecha.com/token?key=MY_NOPECHA_KEY&id=PHN2ZyB3aWR0aD0

{
    'key': 'MY_NOPECHA_KEY',
    'id': 'PHN2ZyB3aWR0aD0'
}

AI has generated the token

AI has not yet generated the token

{
    'data': '03AEkXODDX8VLP-TmomOFDLEd33JLQDrVqb4Lb1lMeuvlCUjrYzIasAk-YQ...'
}

{
    'error': 14,
    'message': 'Incomplete job'
}

# Example code using client libraries

# Install the client using the following command:
# pip install --upgrade nopecha

import nopecha
nopecha.api_key = 'YOUR_API_KEY'

# Call the Token API
token = nopecha.Token.solve(
    type='recaptcha3',
    sitekey='6LfZRA8jAAAAAPDv_kHq_QhvdDKkB90dtTheEMAu',
    url='https://nopecha.com/demo/recaptcha#v3',
    data={
        'action': 'check',
    }
)

# Print the token
print(token)

// Install the client using the following command:
// npm i nopecha

const { Configuration, NopeCHAApi } = require('nopecha');

const configuration = new Configuration({
    apiKey: 'YOUR_API_KEY',
});
const nopecha = new NopeCHAApi(configuration);

(async () => {
    // Call the Token API
    const token = await nopecha.solveToken({
        type: 'recaptcha3',
        sitekey: '6LfZRA8jAAAAAPDv_kHq_QhvdDKkB90dtTheEMAu',
        url: 'https://nopecha.com/demo/recaptcha#v3',
        data: {
            action: 'check',
        },
    });

    // Print the token
    console.log(token);
})();