Smartproxy

Getting started

Proxy location: country / city

Country:

With a residential plan, you can choose from 195+ different locations and 8 cities. Also, we added all fifty states of the USA to our proxy location list. As for the datacenter plan, we offer reliable and fast proxies from US datacenters.

We are continually adding more IPs to our network! To find all locations available, login to your dashboard, open the Endpoint generator tab or simply check here.

City:

Available cities: New York | Los Angeles | Chicago | Houston | Miami | London | Berlin | Moscow

Open the Endpoint generator tab in the dashboard to filter proxy address (location) and port (session) that you will use while connecting to a specific proxy pool via the domain:port format.

Use the proxy location filter to find a specific country or city.



proxy sever location list

Residential proxies can be accessed through country-specific or city-specific ports by using your login credentials : username and password or via whitelisted IPs.

You can also access your proxies through a single backconnect endpointgate.smartproxy.com:7000. In this case, you need to pass the country/city parameter alongside your username and password.

Not using Smartproxy yet? Get your account here

More

Domain:port vs IP:port format

Domain:port

While using Smartproxy you will connect to specific proxy pools by using domain:port format (e.g. us.smartproxy.com:10000) and authentication.



domain port format explained

That means that to connect to a specific proxy pool you need to decide on:

Set authentication methods in dashboard ‘Proxy user’ or ‘Whitelist’ tabs and filter right proxy in ‘Proxy server’ tab.

IP:Port format

Our server’s IP may change at any time. We do not recommend using IP:Port format unless it’s absolutely necessary (e.g. if your application does not accept the default endpoint:port format). Find instructions here.

More

Proxy authentication: proxy user (user:pass) authorization or IP based whitelisting

While using Smartproxy you will connect to a specific proxy pool by using authentication and domain:port format (a.k.a. endpoint:port).

Smartproxy residential proxies can be accessed via two different types of authentication:

See how username:password and whitelist authentication is used in cURL here.


1. Proxy user a.k.a. username:password (RESI and DC proxies).



proxy user explained

Proxy user is one of authentication method. It lets you authorize with User:Pass. If you choose this authentication method, you will need to use ‘Username’ and ‘Password’ credentials together with your selected ‘Port’.

Once you have a subscription plan, go to the ‘Proxy User’ tab in the dashboard and create proxy user. Set limits, follow traffic dedicated to different tasks, locations, or similar. If you need you can purchase additional proxy users at any time.

With user:pass authentication you will be able to use rotating or sticky sessions for up to 1, 10, 30 minutes.



RESI proxy user

2. IP-based whitelisting (RESI proxies).

IP whitelisting allows you to create lists of trusted IP addresses. If you choose whitelist authentication method, you won’t need to use credentials – whitelisted IP addresses do not require the user:pass authentication. You can whitelist your IP in the Whitelisted IPs tab on the left.

With whitelist authentication you will be able to use rotating or sticky sessions for up to 10 minutes.

Find more detailed instructions here.



RESI IP whitelist

More

Proxy server: filter right proxy pool

Using Smartproxy is fairly simple. To connect to a specific proxy pool you will authenticate and use domain:port format that you can create by:

Opt. 1: Use residential / datacenter proxy server filter to get proxy address and ports according to your needs.

1. Choose proxy type. In the dashboard choose ‘proxy server’ tab on the left and then choose proxy type RESI/DC according to your plan and goal.


proxy type selection

2. Select port (session). Port/Port range determines session you will use: rotating or sticky. Read more about ports (sessions) here.



Sticky vs rotating port

3. Select proxy address. It determines location you want to reach. Choose whether you want a random IP or target specific country/city. Read more about proxy address (locations) here.



RESI proxy sever location list

4. Result. The system will filter a relevant proxy server address and port. After deciding on your authentication method, use it with your bot / tool or cURL.



example of the Smartproxy rotating endpoint for the Netherlands

Opt. 2: Use ‘Curl test example’

cURL is a command line tool that lets you transfer data from or to servers with URL syntax commands.

In the ‘Proxy server’ > cURL test example tab the system will generate an proxy server example in the domain:port format (see the ‘shell example’ box).

To get the cURL command example, you will need to: a) select your authentication method, b) choose port parameters, c) and enter your target website. Once you choose and fill all parameters your shell example is ready to copy to clipboard and be tested!

See the example below with a random rotating port specified. For more cURL examples go here.



curl test example

More

Proxy address: choosing location endpoint

While using Smartproxy you will connect to a specific proxy pool by using domain:port format (a.k.a. endpoint:port) and authentication.



domain example

To form correct domain:port format you need port number and proxy address. Proxy address (endpoint) is determined by location you want to target. Example: random country rotating session with domain:port format will look like this: gate.smartproxy.com: 7000

You need to use proxy address to connect to the proxy pool or in other words to connect to specific location. For example: if you need residential IPs from any location you will use random proxy address (endpoint) gate.smartproxy.com and for specific location, e.g. USA us.smartproxy.com.



smartproxy proxy address

Use proxy location filter to find specific country or city. With residential plan you can choose from 195+ locations and 8 cities while with datacenter plan we offer US proxies.



RESI proxy sever location list

You can find both proxy addresses and ports under ‘Proxy server’ tab in the dashboard. There, accordingly to your plan (RESI/DC) you can filter proxy address and ports and later on use it within your tool / bot or cURL.

More

Proxy ports: sticky and rotating sessions

First, you need to connect to a specific proxy pool by using using domain:port format (a.k.a. endpoint:port) and authentication.

To form the right domain:port format, you need the proxy address and port number. Port number is determined by session type. Example: random country rotating session with domain:port format will look like this: gate.smartproxy.com:7000

port example

There are two sessions that you can choose from in Smartproxy:

rotating or Sticky IP sessions

To find these options, you need to click on the Endpoint generator tab in your Dashboard and choose which kind of proxies, datacenter, or residential, you want to use.

1. Rotating IP sessions.

In this case, IPs change automatically with every connection request. For example, you can open a website with one IP address, but when you take further action, such as reloading the website or opening a new link, the IP will change instantly.

Rotating Sessions

2. Sticky IP sessions

Session stickiness can be translated to session persistence. This means that the proxy will not change with each new request, and the IP address will stay the same for an extended period of time. Our datacenter proxy session can last for up to 30 minutes, and you can choose our residential proxy session length between 1 minute, up to 10 or up to 30 minutes while using user:pass authentication and up to 10 min with whitelist authentication.

Sticky Sessions

When you start your session, the countdown begins when you send your first request. The session terminates when no response is received from an IP address, or there is no activity for 60 seconds in that session. After the session’s termination, you will receive a new sticky IP address. The same rules will apply to this IP address too.

Besides, when you’re using a sticky session, you can use any port(s) in the ports range to connect to the proxy server (endpoint). You can also download your filtered list of domain:ports by clicking on Download the list.

The most popular countries have up to 10,000 ports for sticky IPs. For example, it.smartproxy.com: 25762 will allow you to use the same Italian IP address for up to 30 minutes. Please note that this endpoint (it.smartproxy.com) has 10,000 sticky ports, from 20001 to 29999.

More

Using domain:port format in cURL

cURL is a command line tool that lets you transfer data from or to servers with URL syntax commands. You can get cURL example in the dashboard. To find out how, check here.

cURL examples in domain:port format

For a rotating session, random location.

The gate.smartproxy.com:7000 will rotate your IP to an IP address from a random location with every new request.

cURL (with user:pass authorization) will look like:

curl -U user:pass -x gate.smartproxy.com:7000 http://ip.smartproxy.com/json


cURL (with whitelist authorization) will look like:

curl -x gate.smartproxy.io:7000 http://ip.smartproxy.com/json


For a rotating session, specific location.

As in the example below, you can use a single city/country specific proxy address (endpoint) to get a random proxy in that city/country with every query. For example, use us.smartproxy.com:10000 for IP addresses in the US.

cURL (with user:pass authorization) will look like:

curl -U user:pass -x us.smartproxy.com:10000 http://ip.smartproxy.com/json


cURL (with whitelist authorization) will look like:

curl -x us.smartproxy.io:10000 http://ip.smartproxy.com/json


For a sticky session, random location.

Your new IP address will not change with each new request but will stay the same for a longer period (RESI up to 10min, DC 30min). When you need to establish sticky sessions with IP addresses from random locations, use a single backconnect entry node with the sticky session parameter.

cURL (with user:pass authorization) will look like:


curl -U user:pass -x gate.smartproxy.com:10000 http://ip.smartproxy.com/json
curl -U user:pass -x gate.smartproxy.com:10001 http://ip.smartproxy.com/json
curl -U user:pass -x gate.smartproxy.com:10002 http://ip.smartproxy.com/json
...
curl -U user:pass -x gate.smartproxy.com:49999 http://ip.smartproxy.com/json


cURL (with whitelist authorization) will look like:


curl -x gate.smartproxy.io:48509 http://ip.smartproxy.com/json
...


For a sticky session, specific location.

You need to choose sticky ports to keep an IP address from a specific location for longer period. The most popular countries have up to 10,000 ports for sticky IPs. For example, it.smartproxy.com: 25762 will give the same Italian IP address for up to 10 minutes. Please note that this endpoint (it.smartproxy.com) has 10,000 sticky ports, from 20001 to 29999. If needed you can download them all by clicking ‘Download this list’.

cURL (with user:pass authorization) will look like:

curl -U user:pass -x it.smartproxy.com:20001 http://ip.smartproxy.com/json
curl -U user:pass -x it.smartproxy.com:20001 http://ip.smartproxy.com/json
curl -U user:pass -x it.smartproxy.com:20002 http://ip.smartproxy.com/json
...
curl -U user:pass -x it.smartproxy.com:29999 http://ip.smartproxy.com/json


cURL (with whitelist authorization) will look like:

curl -x it.smartproxy.io:21639 http://ip.smartproxy.com/json
...


More

Single backonnect proxies entry node and cURL examples

A backconnect proxy is configurable residential proxy access. You can add specific parameters such as session type, country, city and fully control your connection.

Smartproxy offers single backconnect endpoint: gate.smartproxy.com:7000. To use this endpoint you need to pass all parameters in a string alongside your username and password (whitelist authentication does not work here). For example a location-targeted backconnect proxy server parameter lets you access IPs only from a certain country or city.

As backconnect proxy works only on residential pool, it assigns a new IP address for each rotating request or a sticky IP for up to 10 minutes. If you want to use sticky session use Session ID. Otherwise, just ignore that part to receive a rotating proxy.

The backconnect entry node can be used in various applications. Find more information about backconnect proxies here.

You will need to pass every parameter for your session alongside the username in the username field like this: user-username-country-country_code-city-city_name-session-randomstring. Few examples:


Random proxy from a random country/city

curl -U username:password -x gate.smartproxy.com:7000 http://ip.smartproxy.com/json


Random proxy from a specific country and random city

Example of rotating Italy proxy.

curl -U user-username-country-it:password -x gate.smartproxy.com:7000 http://ip.smartproxy.com/json


A specific country with sticky proxy (using session ID)

Example of sticky Portugese proxy using session ID randomstring123 – session ID defined by string of your choice.

curl -U user-username-country-pt-session-randomstring123:password -x gate.smartproxy.com:7000 http://ip.smartproxy.com/json


A specific country and city with sticky proxy (using session ID)

Example of sticky US – New York proxy using session ID randomstring123 – session ID defined by string of your choice.

curl -U user-username-country-us-city-new_york-session-randomstring123:password -x gate.smartproxy.com:7000 http://ip.smartproxy.com/json



More

Public API

With Smartproxy API you will be able to access proxies and take full control over your account.

-Create, Update, Delete and set traffic limits for your proxy users.

-Pull out reports for traffic usage.

-Create and Delete whitelisted IPs to simplify authentication.

-Filter and list all endpoints with ports.

-Check the status of your current subscription.


Find API documentation here.

In case you need more examples, visit our Github repository.

Read blogpost here.

More

Contact us

Proxies are very fast, huge variety of country targeting. Almost none delay when loading in browser, no errors in scraping and high posting rate for comments or blogs using different SEO tools.
SEO user
Fast proxies & ability to access all the services I needed. Supports remote DNS & didn't leak any privacy data.
Multiple social media account owner

    Provided data is processed for purposes of administering your inquiry and informing you about our services. Please read our Privacy Policy.

    [recaptcha size:normal]


    This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.