Proxy Quickstart

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

Server	Port
`ip.nimbleway.com`	`7000`

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

Get your credentials

Obtain your account name, pipeline name, and password from the Nimble Legacy Dashboard

Soon will be supported in Nimble Platform

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
`country`	Target specific country (ISO Alpha-2)	`country-US`
`state`	Target US/CA states	`state-CA`
`city`	Target specific city	`city-new_york`
`session`	Maintain sticky session	`session-{sessionId}`
`geosession`	Geo-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

Blocked Domains

Requests targeting the following domains are blocked and will be rejected.

View blocked domain list

*.paypal.com
account.sonyentertainmentnetwork.com
acopic.click
adskpak.com
amctheatres.com
andromedabee.com
antliabee.co.uk
api.groupon.com
api.stripe.com
api.tyrads.com
apusbee.co.uk
auth.api.sonyentertainmentnetwork.com
bellarmine.click
caixa.gov.br
callofduty.com
canal-plus.com
clubmium.com
clubmium.net
couponcabin.com
crunchyroll.com
dazn.com
directv.com
ea.com
epicgames.com
fustian.click
gomobile.it
googlecm.hit.gemius.pl
hbo.com
hitspro.net
honeyga.in
honeygain.com
honeygain.money
hotstar.com
iplogger.org
kayak.com
mojang.com
mte.gov.br
music-box.mobi
mybip.it
myy.io
native.np.ac.playstation.net
networkcontroller.net
ocmey.com
onevanilla.com
ordo.link
pagseguro.com
paypal.com
playstation.com
playstation.net
plex.tv
powerbrowsing.online
revenuevelocity.eu
roblox.com
runescape.com
seasyvendas.com
sky.com
sport4life.mobi
spotify.com
ssfcu.com
steamcommunity.com
steampowered.com
torrentdownloads.me
ttvnw.net
tyrads.com
tyrrewards.com
ubi.com
ubisoft.com
unrealengine.com
usps.com
valuedopinions.com
vrv.co
wellsfargo.com
www.ltv-mob.com
yogini.top
zelator.in

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:

Authentication

Username/password and IP allowlist authentication methods

Geotargeting

Country, state, and city-level location targeting

Session Control

Sticky sessions, geo-sessions, and rotation settings

Response Codes

Error codes and troubleshooting guide

Introduction

Web Search Agents

Web Tools

Guides

SDKs

Admin

Quick Start

Connection Format

Example Request

Example Response

How it works

Parameters

Usage

Country targeting

Target state or city

Sticky sessions

Combined geotargeting and session

Maintain geo-session

Blocked Domains

Use cases

Geo-restricted Content

Price Monitoring

SERP Data Collection

Brand Protection

Features

Authentication

Geotargeting

Session Control

Response Codes

Introduction

Web Search Agents

Web Tools

Guides

SDKs

Admin

Documentation Index

​Quick Start

​Connection Format

​Example Request

​Example Response

​How it works

​Parameters

​Usage

​Country targeting

​Target state or city

​Sticky sessions

​Combined geotargeting and session

​Maintain geo-session

​Blocked Domains

​Use cases

Geo-restricted Content

Price Monitoring

SERP Data Collection

Brand Protection

​Features

Authentication

Geotargeting

Session Control

Response Codes

Quick Start

Connection Format

Example Request

Example Response

How it works

Parameters

Usage

Country targeting

Target state or city

Sticky sessions

Combined geotargeting and session

Maintain geo-session

Blocked Domains

Use cases

Features