Token-based method of hCaptcha. The method is very similar to reCAPTCHA V2. The token can be used on the target website within the h-captcha-response form field or passed to a callback function.

HCaptchaTaskProxyless Task object structure#

websiteURLStringYesThe complete URL of the target page, where the Captcha is loaded
websiteKeyStringYeshCaptcha website key. Can be found in the `data-sitekey` attribute of the hCaptcha div element or the `sitekey` parameter of a request to the hCaptcha API
isInvisibleBooleanNoWorks with hCaptcha invisible version - no checkbox but challenge will appear. Typically used with callback functions
enterprisePayloadObjectNoAn Object containing additional parameters, such as: `rqdata`

Request example#

API endpoint: https://api.nextcaptcha.com/createTask

method: POST

Content type: application/json

    "clientKey":"api key",
    "task": {
        "enterprisePayload": {
                "rqdata": "eyJ0eXAi"

Response example#

    "errorId": 0,
    "status": "ready",
    "solution": {
        "respKey": "E0_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9",
        "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36 Edge/16.16299",
        "gRecaptchaResponse": "P1_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9"
    "createTime": 1701234567890,
    "endTime": 1701234567890

Sample Code#

# https://github.com/nextcaptcha/nextcaptcha-python
import os
import sys
from nextcaptcha import NextCaptchaAPI
client_key = os.getenv('NEXTCAPTCHA_KEY', "YOUR_CLIENT_KEY")
api = NextCaptchaAPI(client_key=client_key)
  result = api.hcaptcha(website_url="https://example.com", website_key="SITE_KEY")
except Exception as e:
  sys.exit('solved: ' + str(result))

Related Links#