Reference

CaptchaAI Supported CAPTCHA Types Feature Matrix

Every CAPTCHA type CaptchaAI can solve, with method identifiers, required parameters, and capabilities.


Token-Based CAPTCHAs

reCAPTCHA Family

Feature v2 Checkbox v2 Invisible v3 Enterprise
Method userrecaptcha userrecaptcha userrecaptcha userrecaptcha
Key param googlekey googlekey googlekey googlekey
Extra params invisible=1 version=v3, action, min_score enterprise=1
Proxy support Yes Yes Yes Yes
Browser needed No No No No
Avg solve time 15-30s 15-30s 20-40s 20-40s
Success rate High High High High

Required parameters for all reCAPTCHA types:

# v2 Checkbox
params = {
    "method": "userrecaptcha",
    "googlekey": "SITEKEY",
    "pageurl": "https://example.com",
}

# v2 Invisible
params["invisible"] = 1

# v3
params["version"] = "v3"
params["action"] = "submit"
params["min_score"] = "0.9"

# Enterprise
params["enterprise"] = 1

Cloudflare Turnstile

Feature Value
Method turnstile
Key param sitekey
Proxy support Yes
Browser needed No
Avg solve time 10-20s
Success rate 100%
params = {
    "method": "turnstile",
    "sitekey": "0x4AAAA...",
    "pageurl": "https://example.com",
}

Cloudflare Challenge

Feature Value
Method cloudflare_challenge
Key param sitekey
Proxy support Yes
Browser needed No
Avg solve time 15-30s
Success rate High
params = {
    "method": "cloudflare_challenge",
    "sitekey": "SITEKEY",
    "pageurl": "https://example.com",
}

hCaptcha

Feature Value
Method hcaptcha
Key param sitekey
Proxy support Yes
Browser needed No
Avg solve time 15-30s
Success rate High
params = {
    "method": "hcaptcha",
    "sitekey": "SITEKEY",
    "pageurl": "https://example.com",
}

Interactive CAPTCHAs

GeeTest v3

Feature Value
Method geetest
Key params gt, challenge
Extra params api_server (optional)
Proxy support Yes
Browser needed No (but challenge extraction may need browser)
Avg solve time 10-20s
Success rate 100%
Response challenge, validate, seccode
params = {
    "method": "geetest",
    "gt": "GT_VALUE",
    "challenge": "CHALLENGE_VALUE",
    "pageurl": "https://example.com",
}

GeeTest v4

Feature Value
Method geetest
Key param gt (captcha_id)
Extra params version=4
Proxy support Yes
Avg solve time 10-20s
Success rate 100%
Response captcha_id, lot_number, pass_token, gen_time, captcha_output
params = {
    "method": "geetest",
    "gt": "CAPTCHA_ID",
    "pageurl": "https://example.com",
    "version": "4",
}

BLS CAPTCHA

Feature Value
Method bls
Key param sitekey
Extra params instructions, code
Proxy support Yes
Avg solve time 15-30s
Success rate 100%
params = {
    "method": "bls",
    "sitekey": "SITEKEY",
    "pageurl": "https://example.com",
}

Image/OCR CAPTCHAs

Base64 Submission

Feature Value
Method base64
Key param body (base64 encoded)
Supported types 27,500+
Max file size 100KB
Formats PNG, JPG, GIF, BMP
Avg solve time 5-15s
params = {
    "method": "base64",
    "body": "iVBORw0KGgo...",
}

File Upload

Feature Value
Method post
Key param file (multipart)
Max file size 100KB

Image/OCR Configuration Parameters

Parameter Type Values Purpose
numeric int 0=any, 1=digits, 2=letters, 3=either, 4=none Restrict character set
regsense int 0=insensitive, 1=sensitive Case sensitivity
minLen int 1-20 Minimum answer length
maxLen int 1-20 Maximum answer length
phrase int 0=word, 1=phrase Allow spaces
calc int 0=text, 1=math Math expression
language int 0=any, 1=Cyrillic, 2=Latin Character set
textinstructions str Solving hint text

Feature Comparison Summary

Capability Token CAPTCHAs Interactive Image/OCR
Browser required No Extraction only No
Proxy support Yes Yes N/A
Token output Single string Multiple fields Text string
Token expiry 120-300s 60-120s N/A
Callback support Yes Yes N/A
Batch solving Yes Yes Yes

Type Detection Helper

import re


def detect_captcha_type(page_source, page_url=""):
    """Detect CAPTCHA type from page HTML and return recommended method."""

    checks = [
        (r'data-sitekey.*cf-turnstile|class=["\']cf-turnstile', "turnstile"),
        (r'challenge-platform.*managed|cf-chl-widget', "cloudflare_challenge"),
        (r'data-sitekey.*h-captcha|class=["\']h-captcha', "hcaptcha"),
        (r'initGeetest4|captcha_id', "geetest_v4"),
        (r'initGeetest|gt=\w{32}', "geetest_v3"),
        (r'data-sitekey.*recaptcha|grecaptcha|recaptcha/api', "recaptcha"),
        (r'bls.*captcha|captcha.*bls', "bls"),
        (r'captcha.*img|img.*captcha|captchaImage', "image_ocr"),
    ]

    for pattern, captcha_type in checks:
        if re.search(pattern, page_source, re.IGNORECASE):
            return captcha_type

    return "unknown"


# Usage
captcha_type = detect_captcha_type(page_html)
print(f"Detected: {captcha_type}")

FAQ

Does CaptchaAI support all reCAPTCHA versions?

Yes — v2 checkbox, v2 invisible, v3 score-based, and Enterprise are all supported with the same userrecaptcha method.

What's the fastest CAPTCHA type to solve?

Image/OCR CAPTCHAs typically solve in 5-15 seconds. Turnstile and GeeTest are the fastest among token-based types.

Can I solve multiple CAPTCHA types in one project?

Yes. Use the type detection helper above to identify the CAPTCHA, then submit with the appropriate method parameter. CaptchaAI handles routing internally.



Every CAPTCHA type, one API — start with CaptchaAI.

Discussions (0)

No comments yet.