Get Started in Minutes

Quick Start

Get up and running with IPLoop proxies in under 5 minutes. Create an account, grab your API key, and start making requests.

Step 1: Sign up at iploop.io

Step 2: Get your API key from the dashboard (new format: iploop_xxxxxxxx_xxxxxxxx...)

Step 3: Make your first request:

# New format (v2) — single API key, no username needed
curl -x http://YOUR_API_KEY@proxy.iploop.io:8880 https://httpbin.org/ip

# With country targeting
curl -x http://YOUR_API_KEY-country-US@proxy.iploop.io:8880 https://httpbin.org/ip

# With Python
import requests

proxies = {
    "http": "http://YOUR_API_KEY@proxy.iploop.io:8880",
    "https": "http://YOUR_API_KEY@proxy.iploop.io:8880"
}

response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(response.json())

Authentication

IPLoop supports API key authentication:

API Key (New Format v2): Your API key now includes everything needed — just use it as the username.

# New format: iploop_{short}_{secret}
http://YOUR_API_KEY@proxy.iploop.io:8880

# Example:
http://iploop_fd80eb86_72dabf65a3e44459423ade99a5e4a83e133c9125@proxy.iploop.io:8880

IP Whitelisting: Whitelist your server IP in the dashboard for password-free access.

http://proxy.iploop.io:8880

Residential Proxies

Our residential proxy network includes 2M+ IPs across 195 countries. Use the proxy gateway with your API key:

# Rotating proxy (new IP each request)
http://YOUR_API_KEY@proxy.iploop.io:8880

# Sticky session (same IP for up to 30 min)
http://YOUR_API_KEY-session-abc123@proxy.iploop.io:8880

Supported protocols: HTTP, HTTPS, SOCKS5 (port 1080 for SOCKS5).

Geo-Targeting

Target specific locations by adding parameters to your API key:

# Target by country
http://YOUR_API_KEY-country-us@proxy.iploop.io:8880

# Target by city
http://YOUR_API_KEY-country-us-city-newyork@proxy.iploop.io:8880

# Target by state
http://YOUR_API_KEY-country-us-state-california@proxy.iploop.io:8880

# Target by ZIP code
http://YOUR_API_KEY-country-us-zip-10001@proxy.iploop.io:8880

# Target by ASN
http://YOUR_API_KEY-asn-12345@proxy.iploop.io:8880

Session Management

Control IP rotation behavior with session parameters:

# Rotating (default) — new IP each request
http://YOUR_API_KEY@proxy.iploop.io:8880

# Sticky session — maintain same IP
http://YOUR_API_KEY-session-mysession1@proxy.iploop.io:8880

# Session with duration (in seconds, max 1800)
http://YOUR_API_KEY-session-abc-duration-600@proxy.iploop.io:8880

Integrations

IPLoop works with all major tools and frameworks:

ProxyClaw — AI Agent Integration

ProxyClaw is IPLoop's native OpenClaw skill for AI agents. Install it in seconds:

# Install ProxyClaw
$ clawhub install proxyclaw

# Use via API (new format — single key)
curl -x http://$IPLOOP_API_KEY@proxy.iploop.io:8880 \
  https://example.com

# With geo-targeting
curl -x http://$IPLOOP_API_KEY-country-US@proxy.iploop.io:8880 \
  https://example.com

Learn more at proxyclaw.ai or check the GitHub repo.

Error Handling

Common error codes and how to handle them:

407 — Authentication required (check credentials)
429 — Rate limit exceeded (reduce request frequency)
502 — Bad gateway (retry with exponential backoff)
503 — Service temporarily unavailable (retry after 5s)

For all errors, we recommend implementing retry logic with exponential backoff. Our SDKs handle this automatically.