Thunderproxy provides residential, static ISP and datacenter proxies through one gateway. When a CAPTCHA provider or protection system associates a challenge with the visitor’s IP address, CaptchaAI must solve it through the same proxy used to load and submit the page. Otherwise, a correct token can still be rejected.
This guide shows how to choose a Thunderproxy product, build the proxy credentials, enable proxy use in CaptchaAI and keep one IP throughout the complete flow.
Last updated: September 22, 2026
Choose a Thunderproxy proxy type
All three products use the same gateway. You switch products by changing the username suffix rather than rebuilding the integration.
Proxy type | Best for | Session behavior | Price reference |
Targets that evaluate IP reputation | Rotating or sticky | $1.89 per GB at the 25 GB tier with CAPTCHAAI50 | |
Multi-step flows that need one dedicated IP | Fixed for the lease period | From $1.79 per IP | |
High-throughput work on less restrictive targets | Rotating or sticky | $1.29 per GB at the 25 GB tier |
Residential is the usual starting point when address reputation matters. Static ISP is appropriate when the same identity must keep one address for longer workflows. Datacenter offers the lowest cost and faster routing when the target does not require a residential network.
Why the same proxy must be used
Some challenge systems associate a token with the IP address that requested it. In that case, three steps must use the same address:
Load the protected page.
Ask CaptchaAI to solve the challenge through your proxy.
Submit the returned token from that same proxy.
Cloudflare documents that Turnstile tokens are valid for 300 seconds and can be validated only once. Completing the flow promptly and keeping one address throughout it avoids an IP mismatch or an expired token.
Not every CAPTCHA needs a proxy. CaptchaAI recommends using one when the target enforces IP matching, while simple image, text or audio tasks generally do not benefit from the additional connection.
Build your Thunderproxy credentials
Thunderproxy serves HTTP and SOCKS5 connections from the same host:
HTTP: gw.thunderproxy.net:5959
SOCKS5: gw.thunderproxy.net:9595
The product, target country and session mode are encoded in the username:
YOUR_USERNAME-res-US residential, US exit, rotates per request
YOUR_USERNAME-res-US-sid-12345678 residential, US exit, sticky session
YOUR_USERNAME-res-US-sid-12345678-ttl-300 sticky session with a 300-second TTL
YOUR_USERNAME-dc-DE-sid-30590266 datacenter, German exit, sticky session
YOUR_USERNAME-stc-isp-sid-1 first dedicated static ISP address
Use a two-letter uppercase country code such as US or DE. The -sid- suffix requires an eight-digit session ID. Reusing that username keeps requests on the same address, subject to peer availability for residential connections. A 300-second TTL is a practical default for a short challenge flow.
The Quick Access configurator in the Thunderproxy dashboard assembles the complete credential string, so you can copy the host, port and suffix order directly.
The Quick Access configurator shows the selected protocol and generates the complete proxy string.
Country and state targeting can also be selected in the dashboard before copying the generated credentials.
Country and state targeting with Sticky mode and a 300-second TTL.
Enable proxy use in CaptchaAI
Before sending a proxy-based task, sign in to CaptchaAI and open captchaai.com/config. Enable proxy usage from your account settings. You do not need to contact support to activate it.
CaptchaAI expects the proxy value without a URL scheme:
YOUR_USERNAME-res-US-sid-12345678-ttl-300:[email protected]:5959
Set proxytype to match the protocol and port you selected. Use HTTP with port 5959 or SOCKS5 with port 9595.
Pass the proxy to CaptchaAI with Python
The following example submits a reCAPTCHA v2 task through one sticky residential address. It focuses only on the proxy-related fields; keep your existing polling and error handling around the request.
import random
import requests
API_KEY = "YOUR_CAPTCHAAI_API_KEY"
SITE_KEY = "SITE_RECAPTCHA_KEY"
PAGE_URL = "https://target-site.com/form"
session_id = random.randint(10000000, 99999999)
username = f"YOUR_USERNAME-res-US-sid-{session_id}-ttl-300"
proxy_value = (
f"{username}:YOUR_PASSWORD@"
"gw.thunderproxy.net:5959"
)
response = requests.post(
data={
"key": API_KEY,
"method": "userrecaptcha",
"googlekey": SITE_KEY,
"pageurl": PAGE_URL,
"proxy": proxy_value,
"proxytype": "HTTP",
"json": 1,
},
timeout=30,
)
print(response.json())
Load the target page and submit the finished token through the same sticky username. Do not generate a new session ID between those steps. If you use a dedicated static ISP address, select the same -stc-isp-sid-N index for the entire flow.
Before spending a solve, you can verify the address with:
For a larger list, the free proxy checker reports connection status, response time, exit IP and location.
Troubleshooting
Issue | Likely cause | Fix |
407 Proxy Authentication Required | Incorrect password or malformed username | Copy the credentials again from Quick Access and retest with cURL |
Proxy task rejected by CaptchaAI | Proxy use is disabled in the account | Enable it at captchaai.com/config |
Token is solved but rejected | Page load, solve and submit used different IPs | Reuse one sticky session ID or one static ISP address |
Wrong exit country | Invalid country suffix | Use an uppercase two-letter code such as US, not USA or us |
Pricing and CaptchaAI discount
At the 25 GB tier, rotating residential costs $47.37, or $1.89 per GB, when coupon CAPTCHAAI50 is applied at checkout. Rotating datacenter at the same tier costs $32.25, or $1.29 per GB. Static ISP addresses start at $1.79 per IP. These prices were checked on September 22, 2026.
Frequently asked questions
Do all CaptchaAI tasks need a proxy?
No. Use a proxy when the target associates the challenge with the visitor’s IP address. In that situation, the page load, solve and token submission must share one address. Basic image, text and audio tasks generally do not require a proxy.
Should I use a rotating or sticky session?
Use a sticky residential session or a static ISP address for any multi-step flow. A fully rotating username may return a different address on each request, which breaks the match between the visitor that received the challenge and the visitor that submits the token.
Can CaptchaAI use Thunderproxy SOCKS5 proxies?
Yes. Use gw.thunderproxy.net:9595 and set CaptchaAI’s proxytype field to SOCKS5. For HTTP connections, use port 5959 and set proxytype to HTTP.
How do I enable proxy usage in CaptchaAI?
Sign in and open https://captchaai.com/config. Enable proxy usage in your account settings before submitting the first proxy-based task. The option is self-service, so no support request is required.
Get started
Create a Thunderproxy account, apply coupon code CAPTCHAAI50, generate a sticky proxy in Quick Access and verify its exit IP before sending your first CaptchaAI task.
About the author
This guide was written by the team at Thunderproxy, a proxy network offering rotating residential, static ISP and rotating datacenter IPv4 proxies through one gateway, with location targeting and sticky sessions.
