CaptchaAI Proxy Configuration Guide

Proxies route CaptchaAI's solving traffic through your chosen IP address. They are mandatory for Cloudflare Challenge and recommended for better success rates on other CAPTCHA types. This guide covers setup from scratch.

When you need a proxy

Proxy format

CaptchaAI requires two parameters for proxy configuration:

proxytype: HTTP | HTTPS | SOCKS4 | SOCKS5
proxy: host:port:username:password

With authentication

data = {
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": "SITEKEY",
    "pageurl": "https://example.com",
    "proxytype": "HTTP",
    "proxy": "192.168.1.1:8080:myuser:mypassword",
    "json": 1
}

Without authentication

data = {
    "key": "YOUR_API_KEY",
    "method": "cloudflare_challenge",
    "pageurl": "https://example.com",
    "proxytype": "HTTP",
    "proxy": "192.168.1.1:8080",
    "userAgent": "Mozilla/5.0 ...",
    "json": 1
}

Proxy types

HTTP proxy

The most common type. Works with most residential proxy providers.

data["proxytype"] = "HTTP"
data["proxy"] = "host:port:user:pass"

HTTPS proxy

Same as HTTP but with SSL/TLS encryption between your proxy and the target. Use when your proxy provider requires SSL.

data["proxytype"] = "HTTPS"
data["proxy"] = "host:port:user:pass"

SOCKS5 proxy

Lower-level proxy protocol. Handles any traffic type but requires SOCKS5 support in the solving infrastructure.

data["proxytype"] = "SOCKS5"
data["proxy"] = "host:port:user:pass"

SOCKS4 proxy

Older protocol with no authentication support. Rarely needed.

data["proxytype"] = "SOCKS4"
data["proxy"] = "host:1080"

Residential vs datacenter proxies

Recommendation: Use residential proxies for Cloudflare Challenge and reCAPTCHA Enterprise. Datacenter proxies work for Image/OCR and development.

Common proxy providers format mapping

Different proxy providers format connections differently. Here is how to convert:

Standard format

Provider gives: http://user:pass@host:port
CaptchaAI needs: proxytype=HTTP, proxy=host:port:user:pass

IP-whitelisted (no auth)

Provider gives: host:port
CaptchaAI needs: proxytype=HTTP, proxy=host:port

Rotating proxy with session

Provider gives: http://user-session-abc123:pass@gate.provider.com:5432
CaptchaAI needs: proxytype=HTTP, proxy=gate.provider.com:5432:user-session-abc123:pass

Testing proxy before use

Always verify your proxy works before sending it to CaptchaAI:

import requests

proxy_url = "http://user:pass@host:port"

try:
    resp = requests.get("https://httpbin.org/ip", proxies={
        "http": proxy_url,
        "https": proxy_url
    }, timeout=10)
    print(f"Proxy IP: {resp.json()['origin']}")
except Exception as e:
    print(f"Proxy failed: {e}")

Special characters in credentials

If your password contains @, :, #, or other special characters, URL-encode them:

from urllib.parse import quote

password = "p@ss:w0rd#123"
encoded_password = quote(password, safe="")
# Result: p%40ss%3Aw0rd%23123

data["proxy"] = f"host:port:user:{encoded_password}"

Cloudflare Challenge — proxy binding

For Cloudflare Challenge, the proxy used during solving must be the same proxy used for subsequent requests:

PROXY = "host:port:user:pass"
USER_AGENT = "Mozilla/5.0 ..."

# Solve with these
data = {
    "key": "YOUR_API_KEY",
    "method": "cloudflare_challenge",
    "pageurl": "https://example.com",
    "proxytype": "HTTP",
    "proxy": PROXY,
    "userAgent": USER_AGENT,
    "json": 1
}

# Browse with the same proxy and User-Agent
session = requests.Session()
session.headers["User-Agent"] = USER_AGENT
session.proxies = {
    "http": f"http://user:pass@host:port",
    "https": f"http://user:pass@host:port"
}
session.cookies.set("cf_clearance", solved_value, domain=".example.com")

FAQ

Do I need a proxy for reCAPTCHA v2?

No. Proxies are optional for reCAPTCHA v2. However, using a residential proxy may reduce the difficulty of image challenges.

Can I use free proxies?

Not recommended. Free proxies are slow, unreliable, and often blacklisted. They will result in low solve rates and frequent errors.

My proxy uses IP whitelisting. Will it work?

Only if CaptchaAI's servers are whitelisted. Since CaptchaAI connects from its own IPs, IP-whitelisted proxies usually fail. Switch to username/password authentication.

Configure proxies with CaptchaAI

Set up reliable proxy configuration at captchaai.com.

Related guides

• Proxy Setup Best Practices
• SOCKS5 Proxy CaptchaAI Setup
• Proxy Connection Failures Troubleshooting
• Proxy Quality Affects Solve Rate