← Back to Documentation

Geo-Targeting Guide

Country Targeting

Add -cc-XX to your auth string using the ISO 3166-1 alpha-2 country code:

# Target United States
customer-YOUR_ID-cc-US:API_KEY

# Target Germany
customer-YOUR_ID-cc-DE:API_KEY

# Target Brazil
customer-YOUR_ID-cc-BR:API_KEY

City Targeting

Add -city-NAME (lowercase, no spaces) after the country code:

# Miami, United States
customer-YOUR_ID-cc-US-city-miami:API_KEY

# London, United Kingdom
customer-YOUR_ID-cc-GB-city-london:API_KEY

# Tokyo, Japan
customer-YOUR_ID-cc-JP-city-tokyo:API_KEY

# São Paulo, Brazil
customer-YOUR_ID-cc-BR-city-saopaulo:API_KEY
️ City targeting requires country targeting. Always include -cc-XX before -city-NAME.

ASN / ISP Targeting

Target a specific Internet Service Provider by ASN number:

# Target Comcast (ASN 7922)
customer-YOUR_ID-cc-US-asn-7922:API_KEY

# Target Deutsche Telekom (ASN 3320)
customer-YOUR_ID-cc-DE-asn-3320:API_KEY

Available Locations

IPLoop covers 195+ countries with residential IPs. Top locations by pool size:

CountryCodePool Size
🇺🇸 United StatesUS30M+ IPs
🇬🇧 United KingdomGB8M+ IPs
🇩🇪 GermanyDE6M+ IPs
🇫🇷 FranceFR5M+ IPs
🇧🇷 BrazilBR4M+ IPs
🇮🇳 IndiaIN4M+ IPs
🇯🇵 JapanJP3M+ IPs
🇨🇦 CanadaCA3M+ IPs
🇦🇺 AustraliaAU2M+ IPs
🇰🇷 South KoreaKR2M+ IPs

Combining Parameters

# US, Miami, sticky session for 30 min
customer-YOUR_ID-cc-US-city-miami-sesstype-sticky-lifetime-30:API_KEY

# UK, London, Comcast ASN, rotating
customer-YOUR_ID-cc-GB-city-london-asn-5089:API_KEY