Skip to main content
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

Connection Format

http://account-{accountName}-pipeline-{pipelineName}:{pipelinePassword}@ip.nimbleway.com:7000
ServerPort
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

1

Get your credentials

Obtain your account name, pipeline name, and password from the Nimble Legacy Dashboard
Soon will be supported in Nimble Platform
2

Configure your proxy connection

  • Build your connection string with credentials and optional parameters
  • Add geotargeting (country, state, city) or session control as needed
3

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
4

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:
ParameterDescriptionFormat
countryTarget specific country (ISO Alpha-2)country-US
stateTarget US/CA statesstate-CA
cityTarget specific citycity-new_york
sessionMaintain sticky sessionsession-{sessionId}
geosessionGeo-consistent sessiongeosession-{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: