# hCaptcha

Examples of hCaptcha
Examples of hCaptcha

# Submit the CAPTCHA to NopeCHA

POST https://api.nopecha.com/token/
Parameter Type Required Description
key String Required NopeCHA subscription key.
type String Required hcaptcha
sitekey String Required hCaptcha data-sitekey.
url String Required URL where the hCaptcha is found.
data Dict Optional Extra parameters used to solve the challenge. See data.* parameters below.
data.rqdata String Optional The value of the rqdata as required by custom hCaptcha im.
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.
    'key': 'MY_NOPECHA_KEY',
    'type': 'hcaptcha',
    'sitekey': 'b4c45857-0e23-48e6-9017-e28fff99ffb2',
    'url': 'https://nopecha.com/demo/hcaptcha#easy',
    'data': {
        'rqdata': 'eyJ0eXAiOi...'
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.
    '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(
        'scheme': 'http',
        'host': '',
        'port': '7234',
        'username': 'EhV1AVUbhK',
        'password': 'DJ96p39v9z',

# Print the 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: 'hcaptcha',
        sitekey: 'b4c45857-0e23-48e6-9017-e28fff99ffb2',
        url: 'https://nopecha.com/demo/hcaptcha#easy',
        proxy: {
            scheme: 'http',
            host: '',
            port: '7234',
            username: 'EhV1AVUbhK',
            password: 'DJ96p39v9z',

    // Print the token