Nimble Residential Proxy provides access to a global network of premium residential IPs through a single BackConnect gateway. Route your requests through real residential IPs from 195+ countries with granular geotargeting and session control.
Proxy service requires KYC verification and is not available for self-service accounts. Contact our team to request access.
Quick Start
http://account- {accountName} -pipeline- {pipelineName} : {pipelinePassword} @ip.nimbleway.com:7000
Server Port ip.nimbleway.com7000
Example Request
import requests
proxies = {
'http' : 'http://account-accountName-pipeline-pipelineName:[email protected] :7000' ,
'https' : 'https://account-accountName-pipeline-pipelineName:[email protected] :7000'
}
response = requests.get( 'https://ipinfo.io/json' , proxies = proxies)
print (response.json())
Example Response
{
"ip" : "203.0.113.45" ,
"city" : "Los Angeles" ,
"region" : "California" ,
"country" : "US" ,
"loc" : "34.0522,-118.2437" ,
"org" : "AS12345 Example ISP" ,
"timezone" : "America/Los_Angeles"
}
How it works
Configure your proxy connection
Build your connection string with credentials and optional parameters
Add geotargeting (country, state, city) or session control as needed
Route requests through the proxy
Each request goes through Nimble’s BackConnect gateway
Nimble assigns the best available residential IP
IPs rotate automatically or maintain sticky sessions
Receive responses with residential IP
Target websites see requests from real residential IPs
Response data flows back through the proxy to your application
Parameters
Add parameters to your connection string using hyphens:
Parameter Description Format countryTarget specific country (ISO Alpha-2) country-USstateTarget US/CA states state-CAcityTarget specific city city-new_yorksessionMaintain sticky session session-{sessionId}geosessionGeo-consistent session geosession-{sessionId}
Usage
Country targeting
Route requests through IPs from a specific country:
proxies = {
'http' : 'http://account-accountName-pipeline-pipelineName-country-US:[email protected] :7000' ,
'https' : 'https://account-accountName-pipeline-pipelineName-country-US:[email protected] :7000'
}
response = requests.get( 'https://ipinfo.io/json' , proxies = proxies)
print ( f "Country: { response.json()[ 'country' ] } " )
Target state or city
Precise location targeting states (US and CA only) and/or city(Globally):
# State Targeting
curl -vvv -x http://account-accountName-pipeline-pipelineName-country-US-state-CA:[email protected] :7000 \
https://ipinfo.io/json
# City Targeting
curl -vvv -x http://account-accountName-pipeline-pipelineName-city-new_york:[email protected] :7000 \
https://ipinfo.io/json
Replace spaces from city names with underscore (insteadNew York use new_york).
Sticky sessions
Keep the same IP across multiple requests:
proxies = {
'http' : 'http://account-accountName-pipeline-pipelineName-session-mysession123:[email protected] :7000' ,
'https' : 'https://account-accountName-pipeline-pipelineName-session-mysession123:[email protected] :7000'
}
# Both requests use the same IP
response1 = requests.get( 'https://ipinfo.io/json' , proxies = proxies)
response2 = requests.get( 'https://example.com' , proxies = proxies)
print ( f "Both requests used IP: { response1.json()[ 'ip' ] } " )
Combined geotargeting and session
Target a specific location with a sticky session:
proxies = {
'http' : 'http://account-accountName-pipeline-pipelineName-country-US-state-NY-session-mysession:[email protected] :7000' ,
'https' : 'https://account-accountName-pipeline-pipelineName-country-US-state-NY-session-mysession:[email protected] :7000'
}
# Multiple requests maintain same New York IP
for i in range ( 3 ):
response = requests.get( 'https://ipinfo.io/json' , proxies = proxies)
print ( f "Request { i + 1 } : { response.json()[ 'city' ] } , { response.json()[ 'region' ] } " )
Maintain geo-session
Keep the same IP across multiple requests + maintain geographic proximity and ISP consistency across rotations using geosession:
# First request
curl -vvv -x http://account-accountName-pipeline-pipelineName-geosession-mysession123:[email protected] :7000 \
https://ipinfo.io/json
# Second request - same IP
curl -vvv -x http://account-accountName-pipeline-pipelineName-geosession-mysession123:[email protected] :7000 \
https://example.com
Use cases
Geo-restricted Content Access content as it appears in different countries and regions
Price Monitoring Check prices across different locations for competitive intelligence
SERP Data Collection Gather search results from various locations for SEO analysis
Brand Protection Monitor web presence and detect unauthorized use across regions
Features
Explore detailed documentation for each Proxy feature: