Skip to main content
Country and city geolocation targeting comes as standard with all mobile data purchases. We support over 195 countries and every major city in the world. You can generate proxies which are geolocated to specific countries or cities through both our dashboard generator and through syntax generation in your API requests.

​
Country Targeting

When generating mobile proxies, you can specify the country using the ISO country code: 
# Generate 5 proxies from the United States
curl --request GET \
  --url 'https://api.byteful.com/1.0/public/user/mobile/list?country_id=us&list_count=5' \
  --header 'X-API-Public-Key: your_public_key' \
  --header 'X-API-Private-Key: your_private_key'
This will return proxies exclusively from the specified country: 
{
  "data": [
    "socks5h://your_user_c_us_s_DDINPY7TQ0781XEO:[email protected]:8000",
    "socks5h://your_user_c_us_s_XIINPY7TQ0781XEA:[email protected]:8000",
    "socks5h://your_user_c_us_s_PPINPY7TQ0781XEB:[email protected]:8000",
    "socks5h://your_user_c_us_s_QQINPY7TQ0781XEC:[email protected]:8000",
    "socks5h://your_user_c_us_s_RRINPY7TQ0781XED:[email protected]:8000"
  ],
  "message": "Mobile list successfully created."
}

​
City Targeting

For more precise targeting, you can generate proxies from specific cities: 
# Generate 3 proxies from London, UK
curl --request GET \
  --url 'https://api.byteful.com/1.0/public/user/mobile/list?country_id=gb&city_alias=london&list_count=3' \
  --header 'X-API-Public-Key: your_public_key' \
  --header 'X-API-Private-Key: your_private_key'
Response: 
{
  "data": [
    "socks5h://your_user_c_gb_city_london_s_DDINPY7TQ0781XEO:[email protected]:8000",
    "socks5h://your_user_c_gb_city_london_s_XIINPY7TQ0781XEA:[email protected]:8000",
    "socks5h://your_user_c_gb_city_london_s_PPINPY7TQ0781XEB:[email protected]:8000"
  ],
  "message": "Mobile list successfully created."
}
Notice that the city information is encoded in the proxy string (city_london).

​
Subdivision Targeting

You can also target specific subdivisions (states, provinces, regions) within countries: 
# Generate 3 proxies from California, US
curl --request GET \
  --url 'https://api.byteful.com/1.0/public/user/mobile/list?country_id=us&subdivision_id=us-ca&list_count=3' \
  --header 'X-API-Public-Key: your_public_key' \
  --header 'X-API-Private-Key: your_private_key'

​
Geo-targeting Accuracy

Country targeting for mobile proxies is reliable. State, city and ZIP targeting all work, but accuracy below country level is inherently more inconsistent for mobile IPs than for residential ones. It’s worth understanding why before you rely on it for critical workloads.
The reason comes down to how mobile networks are built. Large carriers like Verizon, AT&T and Vodafone run big, dynamic IP pools behind CGNAT (Carrier-Grade NAT). Those pools are linked to multiple regional gateways, so a single IP in one of these pools has no single fixed location. The same address can be in use by a customer in Texas and another in California at the same time. That makes attributing a mobile IP to one specific city or state genuinely difficult, and you’ll often see different geolocation databases disagree about where the same IP “lives”. How we handle this. We rely on at-point measurement, meaning we record where the IP was actually being used at the time we sampled it. That’s the most accurate signal available for a mobile IP, but it can differ from what other geolocation databases report. When our targeting disagrees with a third party tool, that’s usually a characteristic of these pools rather than an inaccuracy on either side. Why it usually doesn’t matter in practice. Most large websites already understand this behaviour and put less weight on the state, city or ZIP of a mobile IP. They lean primarily on country level signals along with other fingerprints, so unless you specifically need precise regional targeting, the practical impact of any mismatch is small.

​
Finding Available Cities

To discover which cities are available within a country, you can use the city search endpoint: 
# List cities in the United Kingdom
curl --request GET \
  --url 'https://api.byteful.com/1.0/public/user/city/search?country_id=gb&city_is_populous=true' \
  --header 'X-API-Public-Key: your_public_key' \
  --header 'X-API-Private-Key: your_private_key'

​
Combining Geolocation with Other Filters

For advanced targeting, you can combine geolocation with ISP/ASN targeting: 
# Generate 3 proxies from AT&T (ASN 7018) in the US
curl --request GET \
  --url 'https://api.byteful.com/1.0/public/user/mobile/list?country_id=us&asn_id=7018&list_count=3' \
  --header 'X-API-Public-Key: your_public_key' \
  --header 'X-API-Private-Key: your_private_key'

​
Dashboard Generation

You can also easily generate geotargeted proxies through our dashboard interface by selecting the desired country and city from the dropdown menus in the mobile proxy generator. For more information on generating mobile proxies, see the Generating Mobile Proxies guide.