Smartproxy Help Center

Welcome to the Smartproxy developer hub. You'll find comprehensive guides and documentation to help you start working with proxies as quickly as possible, as well as support if you get stuck. Let's jump right in!


Single backconnect entry node

Smartproxy also offers proxy access through a single backconnect endpoint:
Residential -

In this case, you need to pass all parameters alongside username and password.

Here is a list of all available parameters with a description and use:

  • Country – country code. Please provide it in a two symbol ISO format. To get a random country, simply exclude this parameter from the username string.
  • City – city name. Adding this parameter to the authorization header will let you specify which city IP you want to use to process the request. Please use this parameter together with the country information.
  • Session – a random string to create a session in order to keep the same proxy for more than one request. The session automatically expires after 10 minutes (or 60s of inactivity). After that a new IP will be assigned to this session’s ID.


For now, this applies only to residential endpoints. The feature for datacenter endpoints will be coming out soon as well!

//Example of rotating random proxy

curl -U <username>:<password> -x
//Example of rotating Italy proxy

curl -U user-<username>-country-it:<password> -x
//Example of sticky Portugese proxy using session ID
//randomstring123 - session ID defined by string of your choice

curl -U user-<username>-country-pt-session-randomstring123:<password> -x
//Example of sticky US - New York proxy using session ID
//randomstring123 - session ID defined by string of your choice

curl -U user-<username>-country-us-city-new_york-session-randomstring123:<password> -x


Use the Session ID only if you want a sticky session. Otherwise, just ignore that part to receive a rotating proxy.

Using backconnect entry node in applications

The backconnect entry node can be used in various applications as well, in such case, you will need to pass every parameter for your session alongside the username in the username field like this:


In the password field, you only need to enter the password of the proxy user.

Updated 4 months ago

Single backconnect entry node

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.