Proxy Configuation
| Parameter | Type | Default | Description |
|---|---|---|---|
proxy_type |
string | residential |
Proxy type: residential or datacenter |
proxy_country |
string | US |
Two-letter ISO country code (e.g., GB, DE, JP) |
proxy_session_id |
string | - | Session ID (6-8 characters) for IP persistence |
proxy_overwrite |
string | - | Full proxy URL to override default proxies |
Proxy Types Comparison
| Feature | Premium (Residential) | Datacenter |
|---|---|---|
| Request Mode Cost | 2 credits | 1 credit |
| Browser Mode Cost | 5 credits | ❌ Not supported |
| Auto Mode Cost | 2-6 credits | ❌ Not supported |
| Success Rate | Highest | High |
| Speed | Fast | Fastest |
| Best For | Browser/auto modes, geo-restricted content, anti-bot sites | Request mode only, public APIs, high-volume scraping |
Session Management Example:
{
"proxy_session_id": "cart123",
"proxy_country": "US"
}Use the same session ID across multiple requests to maintain the same IP address—perfect for login flows or shopping carts.
See Proxy Types for detailed information.
ℹ️
Captcha Solver: The automatic captcha solver is only active when using
mode="browser" and proxy_type="residential". It is not possible to use the automatic captcha solver with datacenter proxies or request mode.