Advanced Parameters
Residential Proxy Advanced Parameter Specification to Control Your Connection
Smartproxy offers customizable proxy access through a single backconnect endpoint and point:
gate.smartproxy.com:7000. You can use either your username and password or whitelisted IP authentication to specify all proxy parameters directly.
Available Parameters
| Parameter | Example Value | Description |
|---|---|---|
country | us | Country code. Please provide it in a two-symbol ISO format. You can check most of the ISO country codes here. |
city | berlin | City name. Adding this parameter will let you specify the city of the IP you want to use. Please use this parameter together with the country parameter. |
state | us_california | US state. Supports the USA location when you pick us as the country parameter. It will allow you to specify the US state of the IP you want to use. |
session | randomstring123 | A random string to create a session to keep the same IP for more than one request. The session automatically expires within 10 minutes by default. After that, a new IP will be assigned to this session’s ID. Learn more here. |
sessionduration | 180 | Used with session. Specifies the sticky session time in minutes – can be set to any number between 1 and 1440 to override the 10 minute sticky session default. Learn more here. |
zip | 10001 | 5-digit ZIP code. Adding this parameter will let you specify the ZIP code location you want to target. It is only applicable for targeting the USA location and should be used with the country-us parameter string. |
asn | 20057 | Target the ASN number of a specific carrier. You can look up carrier numbers by searching online, for example, here. |
continent | as | Continent code. You can find the continent codes here. |
ASN Filtering
- You must choose between
citytargeting andasntargeting, as they can’t be used simultaneously.- The same logic would apply for the
continent,stateandcountryparameters.
Application Support
User:pass method
The backconnect entry node can be used in various applications as well. In such a case, you will need to pass every parameter for your session alongside the username in the username field like this:
user-SPusername-country-country_code-city-city_name-session-randomstring
In the example above,SPusername represents your proxy username, which you would need to get from the authentication section. In the password field, you only need to enter the proxy user's password.
More info on our User:pass Requests section.
The session ID can be defined by any string of your choice (simply replace the "randomstring123" from the examples). Use a Session ID only if you want a sticky session. Otherwise, just ignore that part to receive a rotating proxy.
Use underscores when a city or state name consists of multiple words. E.g:
las_vegas,us_new_yorkorus_rhode_island.
Whitelisted IP method
Since this method does not include a username, you will have to specify the backconnect parameters in the endpoint like this:
https://country-country_code-city-city_name-session-randomstring.gate.smartproxy.com:7000
More info on our Whitelisted IP Requests section.
Whitelisted IP authentication limitations
- Whitelisted IP authentication only supports
HTTPSrequests.IPv6IP addresses are currently unsupported for Whitelisted IP authentication. Please use IPs that are inIPv4format (xx.xx.xx.xx).
cURL Examples
To use these commands, just replace SPusername and SPpassword with your proxy user credentials and run them in your Terminal or Command Prompt.
Get an IP from a random location with a rotating session
curl -U SPusername:SPpassword -x gate.smartproxy.com:7000 https://ip.smartproxy.com/jsonGet an IP from a specific country (in this example Italy) with a rotating session
curl -U user-SPusername-country-it:SPpassword -x gate.smartproxy.com:7000 https://ip.smartproxy.com/jsonGet an IP from a specific country (in this example Italy) with a 30-minute session duration
curl -U user-SPusername-country-it-sessionduration-30:SPpassword -x gate.smartproxy.com:7000 https://ip.smartproxy.com/jsonGet an IP from Portugal with a session ID
curl -U user-SPusername-country-pt-session-randomstring123:SPpassword -x gate.smartproxy.com:7000 https://ip.smartproxy.com/jsonGet an IP from a specific city (in this example New York City) with a session ID
curl -U user-SPusername-country-us-city-new_york-session-randomstring123:SPpassword -x gate.smartproxy.com:7000 https://ip.smartproxy.com/jsonGet an IP from a specific US state (in this example California)
curl -U user-SPusername-country-us-state-us_california:SPpassword -x gate.smartproxy.com:7000 https://ip.smartproxy.com/jsonGet an IP from a specific US state (in this example the New York State)
curl -U user-SPusername-country-us-state-us_new_york:SPpassword -x gate.smartproxy.com:7000 https://ip.smartproxy.com/jsonGet an IP from a specific US state and city (in this example Austin) with a session ID and a 30-minute session duration
curl -U user-SPusername-country-us-state-us_texas-city-austin-session-randomstring123-sessionduration-30:SPpassword -x gate.smartproxy.com:7000 https://ip.smartproxy.com/jsonGet an IP from a specific US location using ZIP code (in this example New York) with a session ID and a 30-minute session duration
curl -U user-SPusername-country-us-zip-10001-session-randomstring123-sessionduration-30:SPpassword -x gate.smartproxy.com:7000 https://ip.smartproxy.com/jsonUpdated 22 days ago