Advanced
Proxy Configuration
Use Scrpy's global proxy network to access geo-restricted content and avoid IP blocks with automatic rotation.
Proxy Network
Scrpy manages a pool of millions of residential and datacenter IPs across 195+ countries. We handle rotation, retries, and health monitoring automatically.
195+
Countries
50M+
IP Pool
99.9%
Uptime
Geo-Targeting
Specify a country code to route requests through that region:
javascript
{
"url": "https://amazon.co.uk/product/123",
"proxy": "gb", // Route through UK
"selectors": {
"price": ".price"
}
}Popular Country Codes
us - United Statesgb - United Kingdomde - Germanyfr - Franceca - Canadaau - Australiajp - Japanbr - Brazilin - Indiamx - Mexicoes - Spainit - ItalyUse standard ISO 3166-1 alpha-2 country codes. Full list available in the API reference.
Proxy Types
Residential Proxies (Default)
Real residential IPs from ISPs. Best success rates for protected sites.
"proxyType": "residential"Datacenter Proxies
Fast datacenter IPs. Lower cost, good for less protected sites.
"proxyType": "datacenter"Mobile Proxies
4G/5G mobile carrier IPs. Highest trust scores, premium pricing.
"proxyType": "mobile"Advanced Options
javascript
{
"url": "https://example.com",
"proxy": {
"country": "us",
"state": "california", // US state targeting
"city": "los-angeles", // City targeting
"type": "residential", // Proxy type
"sessionId": "abc123" // Sticky session
},
"selectors": { ... }
}Session Persistence
Use sticky sessions to maintain the same IP across multiple requests:
javascript
// Request 1 - Creates session
{
"url": "https://example.com/login",
"proxy": {
"country": "us",
"sessionId": "user-session-123" // Your session ID
}
}
// Request 2 - Same IP
{
"url": "https://example.com/dashboard",
"proxy": {
"country": "us",
"sessionId": "user-session-123" // Same session ID
}
}Sessions persist for 10 minutes of inactivity by default.
Credit Usage
| Proxy Type | Credits per Request |
|---|---|
| No proxy | 1 credit |
| Datacenter | 2 credits |
| Residential | 5 credits |
| Mobile | 10 credits |