CaptchaAI Supported CAPTCHA Types Feature Matrix

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

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"
params["min_score"] = "0.9"

# 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",
}

hCaptcha

params = {
    "method": "hcaptcha",
    "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

params = {
    "method": "geetest",
    "gt": "CAPTCHA_ID",
    "pageurl": "https://example.com",
    "version": "4",
}

BLS CAPTCHA

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

Image/OCR CAPTCHAs

Base64 Submission

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

File Upload

Image/OCR Configuration Parameters

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.