Proxy Setup Guide
Everything you need to connect: the host and ports, how to choose a country or city, how to keep one IP, code you can paste and what each error means. It is the same for residential, mobile and datacenter proxies.
Quick Start
From payment to the first request in about a minute.
- 1Buy trafficChoose a proxy type and how many gigabytes you need. The order is paid from your balance.
- 2Open My proxiesYour login, password and the connection builder are there as soon as the order is paid.
- 3Paste your lineChoose a country and a session type in the builder, copy the line and paste it where your tool asks for a proxy.
To check the connection, run this in a terminal with your own login and password. It prints the IP address your request left from.
curl -x "http://LOGIN:[email protected]:823" https://api.ipify.org/Host, Ports and Login
One host serves all three proxy types. Your login decides which type the traffic uses.
- Host
- proxy.1001sms.com
- HTTP port, a new IP on every request
- 823
- SOCKS5 port, a new IP on every request
- 824
- Sticky ports, one IP each
- 10000 to 20000
- Login and password
- In My proxies
- Each proxy type you buy (residential, mobile, datacenter) has its own login and password.
- In your tool, set the proxy type to HTTP or SOCKS5. An HTTP proxy opens https sites too.
- Sticky ports accept both HTTP and SOCKS5.
- In every example on this page, replace
LOGINandPASSWORDwith your own.
Line formats
Tools ask for a proxy in one of these three forms. The builder in My proxies writes each of them for you.
proxy.1001sms.com:823:LOGIN:PASSWORD
LOGIN:[email protected]:823
http://LOGIN:[email protected]:823Rotating and Sticky Sessions
The port decides whether the IP changes on every request or stays the same for a while.
Rotating
Ports 823 (HTTP) and 824 (SOCKS5). Every new connection leaves from a different IP. Use it to collect many pages or to spread requests over many addresses.
Sticky
Ports 10000 to 20000. Each port keeps one IP, so ten ports give you ten IPs at the same time. Use it for anything that must look like one visitor: a sign-in, a cart, a form with several steps.
- A sticky port keeps its IP for 30 minutes. To set another length, from 1 to 120 minutes, add
sessttlto the login:LOGIN__sessttl.60. - If the IP goes offline before that, another one takes its place and your tool keeps working.
- Sticky ports take the same country, state and city parameters as the rotating ones.
# One French IP for 60 minutes
curl -x "http://LOGIN__cr.fr;sessttl.60:[email protected]:10000" https://api.ipify.org/Country, State and City Targeting
Targeting is written into the login, after two underscores. Nothing else in the connection changes.
A parameter is a name, a dot and a value: cr.us. Separate parameters with a semicolon (cr.us;state.arizona) and several values with a comma (cr.de,fr). With no parameter the IP can be from any country.
crCountry, by its two-letter code. With several codes, the IP is from any of them.
Counted oncenocrAny country except the ones listed.
Counted oncestateA state or region inside the country, for example a US state.
Counted twicecityA city inside the country.
Counted twicezipA postal code inside the country.
Counted twiceasnOne network operator, by its AS number. A mobile carrier, for example.
Counted twicesessttlHow many minutes a sticky port keeps its IP, from 1 to 120.
- State, city, postal code and operator need a country in the same login.
- Those four also count traffic twice: 1 GB sent through such a filter takes 2 GB from your plan. Choosing or excluding a country does not.
- The builder in My proxies lists the states and cities that have IPs online and writes their codes for you.
- If no IP is online for your filter, the proxy answers
503 NO_RAY. Remove the city or state, or choose another country.
Code Examples
Each example prints the IP address the request left from.
# HTTP, a new US IP on every request
curl -x "http://LOGIN__cr.us:[email protected]:823" https://api.ipify.org/
# SOCKS5, a UK IP
curl -x "socks5://LOGIN__cr.gb:[email protected]:824" https://api.ipify.org/
# Sticky: one German IP for 60 minutes
curl -x "http://LOGIN__cr.de;sessttl.60:[email protected]:10000" https://api.ipify.org/import requests
proxy = "http://LOGIN__cr.us:[email protected]:823"
response = requests.get(
"https://api.ipify.org/",
proxies={"http": proxy, "https": proxy},
timeout=30,
)
print(response.text)import { ProxyAgent, fetch } from "undici";
const proxy = new ProxyAgent("http://LOGIN__cr.us:[email protected]:823");
const response = await fetch("https://api.ipify.org/", { dispatcher: proxy });
console.log(await response.text());Apps with separate fields
Browsers, anti-detect browsers and most desktop tools ask for four fields. Host: proxy.1001sms.com. Port: 823 for HTTP, 824 for SOCKS5, or a sticky port. Username: your login with any parameters after it. Password: your password.
How Traffic Is Counted
- Traffic is everything that passes through the proxy in both directions: what you send and what you receive.
- You buy whole gigabytes. They do not expire and there is no monthly fee.
- Buying again adds to the same plan. Your login, password and settings stay as they are.
- State, city, postal code and operator targeting counts traffic twice.
- My proxies shows how much is left. At zero the proxy answers
407 TRAFFIC_EXHAUSTED, and it works again as soon as you add traffic.
Limits and Blocked Destinations
- A new plan allows up to 500 connections at the same time. Above that, new connections get
407 THREADS_EXHAUSTEDuntil others close. - Government websites, banking and payment websites and a short list of other sites are blocked for everyone. The proxy answers
403 SITE_PERMANENTLY_BLOCKED. - These destination ports are open: 53, 80, 443, 853, 5060, 5228, 8080, 8090, 8443 and 8888. Mail ports are closed, and a closed port answers
403 PORT_BLOCKED. - UDP is not available.
- The pools are shared and rotating. There are no dedicated or static IPs.
What the traffic may be used for: Terms of Use
Error Codes
When a request cannot go through, an HTTP proxy answers with one of these.
407 NO_USERThe login or password is not recognised.
Copy both again from My proxies. After a password reset, update it in your tool.
407 TRAFFIC_EXHAUSTEDThe plan has no traffic left.
Add traffic in My proxies. The same login works again at once.
407 THREADS_EXHAUSTEDToo many connections are open at the same time.
Lower the number of parallel requests or close idle connections.
407 PORT_NOT_ALLOWEDThis sticky port is outside your plan's range.
Use the ports the builder in My proxies gives you.
407 USER_BLOCKEDThe plan is blocked.
Contact support.
403 PORT_BLOCKEDThe destination port is closed.
Use an open port. Mail ports are not available.
403 SITE_PERMANENTLY_BLOCKEDThe website is on the blocked list.
It cannot be opened through the proxy.
502 NO_HOST_CONNECTIONThe proxy could not reach the website.
Check the address, then try again or choose another country.
503 NO_RAYNo IP is online for your targeting.
Remove the city or state, or choose another country.
400 Bad RequestThe proxy did not understand the request.
Check the proxy type and the port: 823 is HTTP, 824 is SOCKS5.
500 INTERNAL_SERVER_ERRORA fault on the proxy's side.
Try again. If it keeps happening, contact support.
SOCKS5 has no text answers. A wrong login, used-up traffic or too many connections show as a failed sign-in. A closed port, an unreachable website or no IP for your targeting show as a dropped connection.
Still not connecting?
Send us the line you are using, without the password, and the answer you get.