DocumentationAPI Documentation中文
Documentation
FAQWebsiteDashboard
Start typing to search…

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.

Available Parameters

ParameterExample ValueDescription
countryusCountry code. Please provide it in a two-symbol ISO format. You can check most of the ISO country codes here.
cityberlinCity 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.
stateus_californiaUS 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.
sessionrandomstring123A 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.
sessionduration180Used 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.
zip100015-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.
asn20057Target the ASN number of a specific carrier. You can look up carrier numbers by searching online, for example, here.
continentasContinent code. You can find the continent codes here.

📘

ASN Filtering

  • You must choose between city targeting and asn targeting, as they can’t be used simultaneously.
  • The same logic would apply for the continent, state and country parameters.

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_yorkor us_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 HTTPS requests.
  • IPv6 IP addresses are currently unsupported for Whitelisted IP authentication. Please use IPs that are in IPv4 format (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/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 22 days ago