FAQ: Getting started

Find out everything you need to know about using residential proxies with Smartproxy

More questions are covered here: FAQ: Billing and Smartproxy overview

Proxy location: country / city Domain:port vs IP:port format Step 1. Proxy authentication: proxy user (user:pass) authorization or IP based whitelisting Step 2. Proxy server: filter right proxy pool Step 2.1. Proxy address: choosing location endpoint Step 2.2. Proxy ports: sticky and rotating sessions Using domain:port format in cURL Single backonnect proxies entry node and cURL examples Public API Configure proxies on a browser (extension), laptop or mobile device Integrate proxies with 3rd party software, bots and automation tools Error codes, warnings. Why proxies might not work or connect Usage statistic and used traffic (GBs) tracking What Is Smartproxy? Where Can I Use Your Proxies? Do you have any blocked sites? Shared residential proxies Shared datacenter proxies Create a dashboard account and start using Smartproxy Smartproxy benefits and features How Secure Is Smartproxy Network? HTTP/HTTPS and SOCKS Protocols Dedicated or static IP lists Help documentation and Support Report abuse of Smartproxy service Monthly subscription model and auto-payments Residential proxies pricing plans Datacenter proxies pricing plans Payment methods we accept Free trial and testing proxies Change (upgrade/downgrade/renew) subscription plan Purchasing extra GB traffic (bandwith) Refer a friend How to Become Our Affiliate On Partnerize (Guide) Using discount coupon code Account was not activated after payment Updating payment details Refund policy Canceling subscription Unused GB (traffic): what will happen

Proxy location: country / city

Country:

With residential plan you can choose from 195+ locations and 8 cities while with datacenter plan we offer US proxies. We are constantly adding more IPs to our network! To find all locations available login to the dashboard > ‘Proxy server’ tab on the left or simply check here.

City:

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

Use ‘Proxy server’ tab in the dashboard to filter proxy address (location) and port (session) that you will use while connecting to specific proxy pool via domain:port format.

Use proxy location filter to find specific country or city.



RESI 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

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. 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.

Step 1. 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 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.



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.

Find more detailed instructions here.



RESI IP whitelist

Step 2. 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

Step 2.1. 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.

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.

Step 2.2. Proxy ports: sticky and rotating sessions

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

To form correct domain:port format you need 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

With our proxies, you can choose between two kinds of sessions:

rotating or Sticky IP sessions

1. Rotating IP sessions.

IPs change with each new request. For instance, you open a website with one IP, but when you do any further action, such as reload the website or open a link, your IP will have already changed.



proxy port number

2. Sticky IP sessions

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). The countdown starts with the first request sent. A session gets terminated if no response is received from an IP address or if there’s no activity for 60s for that session. Once a session gets terminated – you will receive a new sticky IP and same rules apply again.

Sticky session provides you with port range. If you use sticky session you can use any port(s) in 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’.



RESI proxy sever and locations list

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.


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.

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
...


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



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.

Configure proxies on a browser (extension), laptop or mobile device

Don’t know how to set up proxies on your browser, laptop or mobile device? No problem! Check out our configuration guides for browsers and proxy manager extensions, smartphones, operating systems here.

If you are interested in using Smartproxy extension read this article.

Integrate proxies with 3rd party software, bots and automation tools

You can integrate Smartproxy proxies with all major automation bots. If your software runs on a dedicated server or your local machine, simply add the machine’s IP to your list of whitelisted IPs. Find integrations here.


Error codes, warnings. Why proxies might not work or connect

If you get HTTP(S) error codes, please check this documentation or get in touch with support via live chat.

Usage statistic and used traffic (GBs) tracking

Traffic is the sum of incoming request size and outgoing content size (request headers + request data + response headers + response data).

You can track your traffic in the dashboard.

Overal traffic details: track your traffic usage and know how many GB you have left. You will be updated via email once you use 80% of your plan.

Filter statistics: select a period and check your usage statistics.



smartproxy traffic usage

Not using Smartproxy yet? Get your account here

Unused GB (traffic): what will happen

– If you downgrade / renew / don’t change your subscription plan (a.k.a. new billing cycle starts), unused GB will not be transferred to the new billing cycle.

– If you upgrade your plan, unused GB will be transferred to the new subscription period.

– If you cancel your monthly subscription and purchase a new plan while your proxies from the last subscription period are still active, your unused GB will be transferred to the new subscription period.

– If you cancel your subscription and do not purchase a new plan while your proxies from the last subscription period are still active, your unused GB will be lost.

GB transfer

Can I transfer my unused GB to the next billing cycle (subscription period)?

You can transfer all unused traffic to the next subscription period when you upgrade to a bigger one. You must upgrade your plan before your current subscription period ends. This also works when your cancelled subscription is still active. See the examples below for more info.

Example:

Lets say your subscription is active until May 1. Even if you cancel your subscription, your remaining traffic is yours to keep until May 1.

If you want to transfer unused GBs to the next subscription period: upgrade to a new plan before May 1 – all unused traffic will be added to the new plan. This works even if you have canceled your current subscription and ordered a new plan before May 1 – all unused GB will still be added to the new plan.

If you cancel your subscription and do not renew your subscription before May 1, your GB will be lost after the last subscription period ends.

Proxy location: country / city

Country:

With residential plan you can choose from 195+ locations and 8 cities while with datacenter plan we offer US proxies. We are constantly adding more IPs to our network! To find all locations available login to the dashboard > ‘Proxy server’ tab on the left or simply check here.

City:

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

Use ‘Proxy server’ tab in the dashboard to filter proxy address (location) and port (session) that you will use while connecting to specific proxy pool via domain:port format.

Use proxy location filter to find specific country or city.



RESI 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

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. 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.

Step 1. 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 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.



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.

Find more detailed instructions here.



RESI IP whitelist

Step 2. 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

Step 2.1. 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.

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.

Step 2.2. Proxy ports: sticky and rotating sessions

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

To form correct domain:port format you need 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

With our proxies, you can choose between two kinds of sessions:

rotating or Sticky IP sessions

1. Rotating IP sessions.

IPs change with each new request. For instance, you open a website with one IP, but when you do any further action, such as reload the website or open a link, your IP will have already changed.



proxy port number

2. Sticky IP sessions

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). The countdown starts with the first request sent. A session gets terminated if no response is received from an IP address or if there’s no activity for 60s for that session. Once a session gets terminated – you will receive a new sticky IP and same rules apply again.

Sticky session provides you with port range. If you use sticky session you can use any port(s) in 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’.



RESI proxy sever and locations list

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.


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.

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
...


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



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.

Configure proxies on a browser (extension), laptop or mobile device

Don’t know how to set up proxies on your browser, laptop or mobile device? No problem! Check out our configuration guides for browsers and proxy manager extensions, smartphones, operating systems here.

If you are interested in using Smartproxy extension read this article.

Integrate proxies with 3rd party software, bots and automation tools

You can integrate Smartproxy proxies with all major automation bots. If your software runs on a dedicated server or your local machine, simply add the machine’s IP to your list of whitelisted IPs. Find integrations here.


Error codes, warnings. Why proxies might not work or connect

If you get HTTP(S) error codes, please check this documentation or get in touch with support via live chat.

Usage statistic and used traffic (GBs) tracking

Traffic is the sum of incoming request size and outgoing content size (request headers + request data + response headers + response data).

You can track your traffic in the dashboard.

Overal traffic details: track your traffic usage and know how many GB you have left. You will be updated via email once you use 80% of your plan.

Filter statistics: select a period and check your usage statistics.



smartproxy traffic usage

Not using Smartproxy yet? Get your account here

Unused GB (traffic): what will happen

– If you downgrade / renew / don’t change your subscription plan (a.k.a. new billing cycle starts), unused GB will not be transferred to the new billing cycle.

– If you upgrade your plan, unused GB will be transferred to the new subscription period.

– If you cancel your monthly subscription and purchase a new plan while your proxies from the last subscription period are still active, your unused GB will be transferred to the new subscription period.

– If you cancel your subscription and do not purchase a new plan while your proxies from the last subscription period are still active, your unused GB will be lost.

GB transfer

Can I transfer my unused GB to the next billing cycle (subscription period)?

You can transfer all unused traffic to the next subscription period when you upgrade to a bigger one. You must upgrade your plan before your current subscription period ends. This also works when your cancelled subscription is still active. See the examples below for more info.

Example:

Lets say your subscription is active until May 1. Even if you cancel your subscription, your remaining traffic is yours to keep until May 1.

If you want to transfer unused GBs to the next subscription period: upgrade to a new plan before May 1 – all unused traffic will be added to the new plan. This works even if you have canceled your current subscription and ordered a new plan before May 1 – all unused GB will still be added to the new plan.

If you cancel your subscription and do not renew your subscription before May 1, your GB will be lost after the last subscription period ends.



Can't find an answer? Contact our 24/7 support team at [email protected]