CaptchaAI Supported CAPTCHA Types Feature Matrix

Every CAPTCHA type CaptchaAI can solve — with method identifiers, required parameters, and capabilities — plus the beta types and the types that are not yet supported.

Token-Based CAPTCHAs

reCAPTCHA Family

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"

# Enterprise
params["enterprise"] = 1

Cloudflare Turnstile

params = {
    "method": "turnstile",
    "sitekey": "0x4AAAA...",
    "pageurl": "https://example.com",
}

Cloudflare Challenge

params = {
    "method": "cloudflare_challenge",
    "sitekey": "SITEKEY",
    "pageurl": "https://example.com",
}

Interactive CAPTCHAs

GeeTest v3

params = {
    "method": "geetest",
    "gt": "GT_VALUE",
    "challenge": "CHALLENGE_VALUE",
    "pageurl": "https://example.com",
}

GeeTest v4 (coming soon)

GeeTest v4 support is on the CaptchaAI roadmap and is not yet available — it can only be described as coming soon. Use GeeTest v3 today; v4 will be added to this matrix when it ships.

BLS CAPTCHA

params = {
    "method": "bls",
    "sitekey": "SITEKEY",
    "pageurl": "https://example.com",
}

Beta Types

These types are supported in beta (rolled out May–June 2026). Always label them "beta" and do not quote a success rate without a measured figure and date.

Image/OCR CAPTCHAs

Base64 Submission

params = {
    "method": "base64",
    "body": "iVBORw0KGgo...",
}

File Upload

Image/OCR Configuration Parameters

Not Currently Supported

CaptchaAI does not currently solve hCaptcha or FunCaptcha. GeeTest v4 support is coming soon.

Feature Comparison Summary

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.

Related Guides

• API Quick Reference
• CAPTCHA Types Matrix

Every CAPTCHA type, one API — start with CaptchaAI.