Proxy Quickstart

Access premium residential IPs through a single BackConnect gateway

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

Python

import requests

proxies = {
    'http': 'http://account-accountName-pipeline-pipelineName:[e-mail]:7000',
    'https': 'https://account-accountName-pipeline-pipelineName:[e-mail]: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:

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:

Python

proxies = {
    'http': 'http://account-accountName-pipeline-pipelineName-country-US:[e-mail]:7000',
    'https': 'https://account-accountName-pipeline-pipelineName-country-US:[e-mail]: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):

cURL

# State Targeting
curl -vvv -x http://account-accountName-pipeline-pipelineName-country-US-state-CA:[e-mail]:7000 \
  https://ipinfo.io/json

# City Targeting
curl -vvv -x http://account-accountName-pipeline-pipelineName-city-new_york:[e-mail]: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:

Python

proxies = {
    'http': 'http://account-accountName-pipeline-pipelineName-session-mysession123:[e-mail]:7000',
    'https': 'https://account-accountName-pipeline-pipelineName-session-mysession123:[e-mail]: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:

Python

proxies = {
    'http': 'http://account-accountName-pipeline-pipelineName-country-US-state-NY-session-mysession:[e-mail]:7000',
    'https': 'https://account-accountName-pipeline-pipelineName-country-US-state-NY-session-mysession:[e-mail]: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:

cURL

# First request
curl -vvv -x http://account-accountName-pipeline-pipelineName-geosession-mysession123:[e-mail]:7000 \
  https://ipinfo.io/json

# Second request - same IP
curl -vvv -x http://account-accountName-pipeline-pipelineName-geosession-mysession123:[e-mail]: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:

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