Proxy Format

Understanding netdash proxy endpoint structure, authentication, and parameter configuration.

Basic Format

netdash proxy endpoints follow this structure:

plan-gateway.netdash.io:port

Components

ParameterValuesDescription
plansolve, scale, opusGateway type
gatewayus, euGeographic region
port1000, 2000, 3000Plan-specific port

Authentication

Provide your username and password using standard HTTP proxy authentication:

http://USERNAME:PASSWORD@solve-us.netdash.io:1000

Credentials are available in your dashboard under API settings.

Session Management

Control IP rotation behavior by appending parameters to your username string.

Sticky Sessions

Maintain the same IP address for a specified duration by adding session and TTL parameters:

username-session-abc123-ttl-15:password
-session-abc123

Unique session identifier. Use any random string. Same session ID maintains the same IP.

-ttl-15

Time-to-live in minutes. Specifies how long to keep the IP active (1-120 minutes).

Rotating Sessions

Get a new IP on every request by omitting session parameters:

username:password

Country Targeting

Route traffic through specific countries using the cc parameter:

username-cc-US-session-abc123-ttl-15:password

Use 2-letter ISO country codes (US, GB, DE, FR, etc.).

Complete Example

A complete proxy URL with all parameters:

http://user-cc-US-session-abc123-ttl-15:password@solve-us.netdash.io:1000

This configuration routes through a US IP, maintains the same session for 15 minutes, and uses the Solve gateway.

Code Examples

curl
curl -x http://user-cc-US-session-abc123-ttl-15:pass@solve-us.netdash.io:1000 \
  https://api.ipify.org?format=json

Gateway Reference

PlanUS GatewayEU Gateway
Solvesolve-us.netdash.io:1000solve-eu.netdash.io:1000
Scalescale-us.netdash.io:2000scale-eu.netdash.io:2000
Opusopus-us.netdash.io:3000opus-eu.netdash.io:3000