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
ParameterFormatExampleDescription
-country-XXISO 2-letter-country-USTarget country
-city-NAMECity name-city-miamiTarget city
-asn-XXXXXASN number-asn-12345Target ISP/ASN
-session-IDCustom string-session-abc123Sticky session ID
-sesstype-TYPEsticky|rotating-sesstype-stickySession type
-lifetime-NMinutes-lifetime-30Session lifetime
-rotate-MODErequest|time|manual-rotate-requestIP rotation mode
-profile-NAMEProfile name-profile-chrome-winBrowser fingerprint
-speed-NMbps-speed-10Min speed requirement
-latency-NMilliseconds-latency-100Max latency
-debug-1Flag-debug-1Enable 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.

  1. Create an account and get your API key from the API Keys page
  2. Use the connection format: http://:[email protected]:8880
  3. Add targeting parameters to the password: KEY-country-US
  4. 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 SuccessOK
403 Access denied by targetRotate IP
407 Authentication requiredCheck key
429 Rate limitedSlow down
502 Node errorRetry
503 No nodes availableTry other geo