CaptchaAI Wrong CAPTCHA Type Error: How to Fix

Submitting a CAPTCHA with the wrong method parameter is the fastest way to waste credits and get errors. When you send userrecaptcha for a Turnstile, or turnstile for a GeeTest, CaptchaAI either returns ERROR_BAD_PARAMETERS, ERROR_CAPTCHA_UNSOLVABLE, or a token that the target rejects.

Symptoms

CAPTCHA type to method mapping

How to identify the CAPTCHA type

reCAPTCHA (any version)

def detect_recaptcha(html):
    if "www.google.com/recaptcha" in html or "www.recaptcha.net" in html:
        if 'data-sitekey="' in html:
            start = html.index('data-sitekey="') + 14
            end = html.index('"', start)
            sitekey = html[start:end]

            if "invisible" in html.lower() or 'data-size="invisible"' in html:
                return {"type": "recaptcha_v2_invisible", "method": "userrecaptcha",
                        "googlekey": sitekey, "extra": {"invisible": 1}}
            return {"type": "recaptcha_v2", "method": "userrecaptcha",
                    "googlekey": sitekey}

        # v3 is loaded via JavaScript, no visible widget
        if "recaptcha/api.js?render=" in html:
            start = html.index("render=") + 7
            end = html.index('"', start) if '"' in html[start:start+50] else html.index("'", start)
            sitekey = html[start:end]
            return {"type": "recaptcha_v3", "method": "userrecaptcha",
                    "googlekey": sitekey, "extra": {"version": "v3"}}
    return None

Cloudflare (Turnstile or Challenge)

def detect_cloudflare(html, status_code):
    if "cf-turnstile" in html or "challenges.cloudflare.com/turnstile" in html:
        sitekey = None
        if 'data-sitekey="' in html:
            start = html.index('data-sitekey="') + 14
            end = html.index('"', start)
            sitekey = html[start:end]
        return {"type": "turnstile", "method": "turnstile", "sitekey": sitekey}

    if status_code in [403, 503] and ("Just a moment" in html or "challenge-platform" in html):
        return {"type": "cloudflare_challenge", "method": "cloudflare_challenge"}

    return None

GeeTest

def detect_geetest(html):
    if "geetest" in html.lower() or "gt.js" in html or "initGeetest" in html:
        return {"type": "geetest", "method": "geetest"}
    return None

Combined detection

import requests

def detect_captcha_type(url):
    """Detect CAPTCHA type on a URL."""
    resp = requests.get(url)
    html = resp.text

    # Check each type
    result = detect_recaptcha(html)
    if result:
        return result

    result = detect_cloudflare(html, resp.status_code)
    if result:
        return result

    result = detect_geetest(html)
    if result:
        return result

    return {"type": "unknown", "method": None}


info = detect_captcha_type("https://example.com/login")
print(f"CAPTCHA type: {info['type']}")
print(f"CaptchaAI method: {info['method']}")

Common mistakes

FAQ

How do I know if it is reCAPTCHA v2 or v3?

reCAPTCHA v2 shows a visible widget (checkbox or image challenge). reCAPTCHA v3 is invisible — it loads via JavaScript with render=SITEKEY and runs in the background.

What if the page uses a CAPTCHA I do not recognize?

Check the page source for known markers: recaptcha, cf-turnstile, geetest, hcaptcha. If none match, it may be a custom image CAPTCHA — use the base64 or post method.

Can I solve Enterprise reCAPTCHA with the standard method?

No. Enterprise reCAPTCHA requires enterprise=1. Without it, the token may solve but the site will reject it because Enterprise tokens have a different structure.

Get your CaptchaAI API key

Solve any CAPTCHA type correctly at captchaai.com.

Related guides

• CaptchaAI Error Codes Reference
• ERROR_BAD_PARAMETERS Request Validation
• Cloudflare Challenge vs Turnstile: How to Detect
• Solve Multiple CAPTCHA Types in One Workflow