Whitelisted IP Requests
Control your connection through custom backconnect parameters with Whitelisted IP authentication
To authenticate your proxy connection, you can use a Whitelisted IP instead of a username and password. To do this, you'll need to specify all of the proxy parameters directly in the endpoint.
Learn how to add a Whitelisted IP here.
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).
Supported 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. |
continent | as | Continent code. You can find the continent codes here. |
Maintaining sessions with ports
Alternatively, you can use ports instead of the
sessionparameter. E.g.:
country-us-sessionduration-60.gate.smartproxy.com:10001;
country-us-sessionduration-60.gate.smartproxy.com:10002;
country-us-sessionduration-60.gate.smartproxy.com:10003.The available port range is
10001-49999.
ASN filtering
- You must choose between
citytargeting andasntargeting, as they can’t be used simultaneously.- The same logic would apply for the
continent,stateandcountryparameters.- You can look up carrier numbers by searching online, for example here.
Examples
Here's an example for Berlin, using a 90-minute long sessionduration parameter and session ID to allow the IP address to persist for multiple requests:
curl -x "https://country-de-city-berlin-session-example1-sessionduration-90.gate.smartproxy.com:7000" "https://ip.smartproxy.com/json"Support
Need help or just want to say hello? Our customer support is available 24/7. You can also reach us anytime via email at [email protected].
Updated 6 days ago