GuidesAPI Reference
Guides
FAQWebsiteDashboard
Start typing to search…

Advanced Parameters

Mobile Proxy Advanced Parameter Specification to Control Your Connection

Decodo offers customizable proxy access through a single backconnect endpoint and point:
gate.decodo.com:7000.

To specify all proxy parameters in your request, you can use one of two methods:

  1. Username and Password.
  2. Whitelisted IP.

Available Parameters

ParameterExample ValueDescription
countryusCountry code. Please provide it in a two-symbol ISO format. You can check most ISO country codes here.
cityberlinCity name. Adding this parameter allows you to specify the city of the IP address 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 is used to create a session, allowing the same IP to be used 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.
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.
zip100015-digit ZIP code. Adding this parameter allows you to 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.

📘

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 also be used in various applications. 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 is available in 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 is available in 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 username and password 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 "username:password" -x "gate.decodo.com:7000" "https://ip.decodo.com/json"
Get an IP from a specific country (in this example Italy) with a rotating session
curl -U "user-username-country-it:password" -x "gate.decodo.com:7000" "https://ip.decodo.com/json"
Get an IP from a specific city (in this example London) with a rotating session
curl -U "user-username-city-london:password" -x "gate.decodo.com:7000" "https://ip.decodo.com/json"
Get an IP from a specific US state (in this example California
curl -U "user-username-country-us-state-us_california:password" -x "gate.decodo.com:7000" "https://ip.decodo.com/json"
Get an IP from AT&T Mobility LLC with a rotating session
curl -U "user-username-asn-20057:password" -x "gate.decodo.com:7000" "https://ip.decodo.com/json"
Get an IP from Portugal with a sticky session
curl -U "user-username-country-pt-session-randomstring123:password" -x "gate.decodo.com:7000" "https://ip.decodo.com/json"
Get an IP from an Android device with a 1-minute session
curl -U "user-username-os-android-sessionduration-1:password" -x "gate.decodo.com:10000" "https://ip.decodo.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.

Support

Still can't find an answer? Want to say hi? We take pride in our 24/7 customer support. Alternatively, you can reach us via our support email at [email protected].

Feedback

Something's missing? Request an article!
Got feedback? Let us know how we're doing and what can be improved.

Updated 4 days ago

```