Documentation
Start Here
Start using Thunderproxy with product guides, setup steps, troubleshooting checks, subscription help, and API references.
Start Here
Thunderproxy docs help you connect proxy subscriptions, export proxy lists, troubleshoot common issues, and automate subscription checks.
Quick answer: choose your product guide first, copy a current proxy string from the dashboard, test it with cURL, then move the same values into your app in the format it expects.
Choose your product
| Product | Start here |
|---|---|
| Rotating Residential | Use Rotating Residential proxies |
| Rotating Datacenter | Use Rotating Datacenter proxies |
| Static ISP | Use Static ISP proxies |
Rotating products use pool access through generated usernames. Static ISP gives you proxy table rows with dedicated IPs for the lease period.
Connect a proxy
Use these guides when you already have a subscription and need to configure an app, scraper, browser profile, or worker.
- Proxy String Formats: choose between URI, user/pass-first, and host-first formats.
- HTTP vs SOCKS5 Proxies: match protocol and port before testing.
- Test a Proxy with cURL: confirm a proxy works outside your app.
- Browser Automation Tools: import proxy lines into browser profiles and automation tools.
Troubleshoot a connection
Start with the issue you see:
- Authentication Failed: fix 407 errors, stale passwords, inactive subscriptions, malformed usernames, and exhausted usage.
- Location Targeting: check country, state, city, and
ANYtargeting. - Sticky Sessions: understand best-effort session behavior and when to regenerate.
- Exported List Not Working: fix stale exports, wrong formats, protocol mismatches, and app imports.
Manage subscription access
Read Activity and Renewals when exported lists stop working, subscriptions expire, usage runs out, or automation needs to check status before a job.
For rotating products, remaining usage matters. For Static ISP, the lease period matters if you want to keep the same IPs.
Automate checks
Use the APIs when your software needs to inspect account or subscription state:
- Account API: list subscriptions and check activity.
- Subscription API: work with subscription data from code.
Test proxy connectivity separately from API checks. A valid API response tells you account state; a cURL proxy test tells you whether a specific proxy line works.