Skip to main content
Nimble Residential Proxy provides access to a global network of premium residential IPs through a single BackConnect gateway. Simple proxy connection with advanced features like geotargeting and session control.
For comprehensive details, parameters, and advanced features, see the Proxy Usage page.

Proxy Quick Start

Proxy Connection Format

http://account-{accountName}-pipeline-{pipelineName}:{pipelinePassword}@gateway.nimbleway.com:7000

Setup

Get your credentials from the Nimble dashboard:
  • Account Name: Your company gateway name
  • Pipeline Name: Pipeline to use (default: “residential”)
  • Pipeline Password: Your pipeline authentication credential

Basic Usage

Send requests through the residential proxy:
curl -x http://account-accountName-pipeline-pipelineName:[email protected]:7000 \
  https://ipinfo.io

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"
}

Common patterns

Target specific country

Route requests through IPs from a specific country:
curl -x http://account-accountName-pipeline-pipelineName-country-US:[email protected]:7000 \
  https://ipinfo.io

Maintain sticky session

Keep the same IP across multiple requests:
# First request
curl -x http://account-accountName-pipeline-pipelineName-session-mysession123:[email protected]:7000 \
  https://ipinfo.io

# Second request - same IP
curl -x http://account-accountName-pipeline-pipelineName-session-mysession123:[email protected]:7000 \
  https://example.com

Target state and city

Precise location targeting for US states and cities:
curl -x http://account-accountName-pipeline-pipelineName-country-US-state-CA:[email protected]:7000 \
  https://ipinfo.io

Next steps

Explore more Proxy features and Web Tools: