Proxy Setup Active
Configure your residential proxy connection — endpoints, credentials, and targeting options
200M+
Available IPs
195+
Countries
99.8%
Success Rate
<1.5s
Avg Response
Setup
Configuration
Documentation
Connection Details
HTTP Proxy
Host
Port
HTTP
Authentication Format
Format
username: (leave empty) password: API_KEY-country-US-city-miami-session-abc123
Code Examples
cURL
Python
Node.js
Java
Go
Example
# Residential proxy request with country targeting curl -x http://:[email protected]:8880 \ https://httpbin.org/ip # With city targeting and sticky session curl -x http://:YOUR_API_KEY-country-US-city-miami-session-abc123-sesstype-sticky@proxy.iploop.io:8880 \ https://httpbin.org/ip
Targeting Parameters
| Parameter | Format | Example | Description |
|---|---|---|---|
| -country-XX | ISO 2-letter | -country-US | Target country |
| -city-NAME | City name | -city-miami | Target city |
| -asn-XXXXX | ASN number | -asn-12345 | Target ISP/ASN |
| -session-ID | Custom string | -session-abc123 | Sticky session ID |
| -sesstype-TYPE | sticky|rotating | -sesstype-sticky | Session type |
| -lifetime-N | Minutes | -lifetime-30 | Session lifetime |
| -rotate-MODE | request|time|manual | -rotate-request | IP rotation mode |
| -profile-NAME | Profile name | -profile-chrome-win | Browser fingerprint |
| -speed-N | Mbps | -speed-10 | Min speed requirement |
| -latency-N | Milliseconds | -latency-100 | Max latency |
| -debug-1 | Flag | -debug-1 | Enable debug mode |
Rotating
New IP for every request. Best for high-volume scraping where IP diversity matters.
-sesstype-rotating
Sticky
Same IP for session duration. Best for multi-page flows, login sessions, checkouts.
-sesstype-sticky-lifetime-30
Per-Request
Explicitly different IP each time. Forces unique exit IP per request.
-rotate-request
Quick Start
Get up and running in under 5 minutes.
- Create an account and get your API key from the API Keys page
- Use the connection format:
http://:[email protected]:8880 - Add targeting parameters to the password:
KEY-country-US - Make your first request!
Authentication
How proxy authentication works.
All requests require authentication via the proxy username and password:
username:password: your_api_key[-parameters]
Parameters are optional and appended with - separator.
️
Error Codes
Common proxy error codes and their meaning.
200 SuccessOK403 Access denied by targetRotate IP407 Authentication requiredCheck key429 Rate limitedSlow down502 Node errorRetry503 No nodes availableTry other geoResources
Helpful links and references.