Advanced Parameters
Mobile 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.
Whitelisted IP authentication limitations
- Whitelisted IP authentication only supports
HTTPS
requests.IPv6
IP addresses are currently unsupported for Whitelisted IP authentication. Please use IPs that are inIPv4
format (xx.xx.xx.xx
).
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
city
targeting andasn
targeting, as they can’t be used simultaneously.- The same logic would apply for the
continent
,state
andcountry
parameters.
Application Support
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.
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_york
orus_rhode_island
.
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/json"
Get 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/json"
Get an IP from a specific city (in this example London) with a rotating session
curl -U "user-SPusername-city-london:SPpassword" -x "gate.smartproxy.com:7000" "https://ip.smartproxy.com/json"
Get 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/json"
Get an IP from AT&T Mobility LLC with a rotating session
curl -U "user-SPusername-asn-20057:SPpassword" -x "gate.smartproxy.com:7000" "https://ip.smartproxy.com/json"
Get an IP from Portugal with a sticky session
curl -U "user-SPusername-country-pt-session-randomstring123:SPpassword" -x "gate.smartproxy.com:7000" "https://ip.smartproxy.com/json"
Get an IP from an Android device with a 1-minute session
curl -U "user-SPusername-os-android-sessionduration-1:SPpassword" -x "gate.smartproxy.com:10000" "https://ip.smartproxy.com/json"
When using any backconnect parameter, your username is also considered one of the parameters, therefore you need to add
user-
prefix before specifying your username, just like with all other parameters.
Updated 6 days ago