ERROR_BAD_PARAMETERS: Request Validation and Fix Guide

ERROR_BAD_PARAMETERS means your request is missing required fields or has invalid values. This guide lists all required parameters per CAPTCHA type.

Required Parameters by Type

reCAPTCHA v2

data = {
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": "6Le-wvkSAAAAAPBMRTvw...",
    "pageurl": "https://example.com",
    "json": 1,
}

reCAPTCHA v3

data = {
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": "SITEKEY",
    "pageurl": "https://example.com",
    "version": "v3",
    "action": "submit",
    "min_score": "0.7",
    "json": 1,
}

Cloudflare Turnstile

data = {
    "key": "YOUR_API_KEY",
    "method": "turnstile",
    "sitekey": "0x4AAAAAAAB...",
    "pageurl": "https://example.com",
    "json": 1,
}

GeeTest v3

data = {
    "key": "YOUR_API_KEY",
    "method": "geetest",
    "gt": "GT_KEY",
    "challenge": "CHALLENGE_TOKEN",
    "pageurl": "https://example.com",
    "json": 1,
}

Image CAPTCHA (Base64)

import base64

with open("captcha.png", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

data = {
    "key": "YOUR_API_KEY",
    "method": "base64",
    "body": image_b64,
    "json": 1,
}

BLS CAPTCHA

Pre-Submit Validation

REQUIRED_PARAMS = {
    "userrecaptcha": ["key", "method", "googlekey", "pageurl"],
    "turnstile": ["key", "method", "sitekey", "pageurl"],
    "geetest": ["key", "method", "gt", "challenge", "pageurl"],
    "base64": ["key", "method", "body"],
    "bls": ["key", "method", "sitekey", "pageurl"],
}


def validate_params(data):
    """Validate required parameters before submission."""
    method = data.get("method")
    if not method:
        raise ValueError("Missing 'method' parameter")

    required = REQUIRED_PARAMS.get(method)
    if not required:
        raise ValueError(f"Unknown method: {method}")

    missing = [p for p in required if not data.get(p)]
    if missing:
        raise ValueError(f"Missing required parameters: {', '.join(missing)}")

    # Format validation
    if "pageurl" in data:
        if not data["pageurl"].startswith(("http://", "https://")):
            raise ValueError("pageurl must start with http:// or https://")

    if "googlekey" in data:
        if len(data["googlekey"]) < 20:
            raise ValueError("googlekey appears too short")

    return True


# Use before every submission
data = {
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": "SITEKEY",
    "pageurl": "https://example.com",
    "json": 1,
}

validate_params(data)

Common Mistakes

Troubleshooting

FAQ

Which parameters are case-sensitive?

Parameter names are case-sensitive. Use lowercase: method, googlekey, pageurl. The method value is also case-sensitive: use userrecaptcha, not UserRecaptcha.

Can I send extra parameters?

Yes. Unknown parameters are ignored. This won't cause BAD_PARAMETERS — only missing required ones will.

How do I know which method to use?

Check the CAPTCHA type on the target page. reCAPTCHA → userrecaptcha, Turnstile → turnstile, GeeTest → geetest, Image → base64 or post.

Related Guides

• WRONG_GOOGLEKEY Diagnosis
• Error Handling Decision Tree

Validate first, solve fast — use CaptchaAI.