How to Use Residential Proxies: Quick Start

Sign up with your email address. Ordinary purchases need no identity verification; we may ask for it only if an account shows signs of abuse.

Choose residential or mobile proxies, enter the number of GB and pay in crypto. Both products draw on one balance, and the rate for your volume tier applies to the whole purchase: residential costs $2.95/GB for 1 GB and falls to $1.95/GB from 1,000 GB; every tier is on the pricing page. Send the exact amount on the network shown at checkout; network fees are paid by the sender. More on paying: buy proxies with crypto.

Your traffic never expires, and all purchases are final. To test your own targets first, start with the Easy Trial: 1 GB at the normal price, on the same pool as a 1 TB order.

Need a fixed IP rather than a rotating pool? Dedicated datacenter proxies and ISP proxies are sold per IP for 30 days. How they are delivered and set up: a list in your dashboard (ip:port:login:password), over HTTP, HTTPS and SOCKS5, each IP with its own login and password. This guide covers residential and mobile proxies.

Your account shows the gateway, gate.proxyfield.io:7000, and your username and password; if you authenticate with the IP allowlist, you connect to the port you set up in the dashboard instead of 7000. The dashboard's configurator generates as many proxy lines as you need, in the form host:port:username:password:

gate.proxyfield.io:7000:<login>-country-us-city-new_york:<password>

You do not get a fixed list of IPs to manage. You connect to one gateway, and it assigns exit IPs from the pool for the location you ask for.

Run the cURL line at the top of this page with your own username and password. An IP that differs from yours means the proxy works; your own IP means your tool is not using the proxy.

Then check that rotation works. Three requests in rotating mode get a new IP each:

for i in 1 2 3; do curl -s -x gate.proxyfield.io:7000 -U "<login>-country-us:<password>" https://api.ipify.org; echo; done
# three different IPs

Add a session ID and a time, and the IP stays the same:

for i in 1 2 3; do curl -s -x gate.proxyfield.io:7000 -U "<login>-country-us-session-test01-ttl-600:<password>" https://api.ipify.org; echo; done
# the same IP three times, for up to 600 seconds

What to expect from a sticky session:

• Without ttl, a session lasts 20 minutes.
• An IP left idle for 120 seconds is replaced by a new one.
• The IP is held while its exit node is up. If the node drops, the gateway retries once with a new session, so the IP may change; a broken connection is not restored, and your client reconnects.

The location goes into the username, in lowercase with underscores for spaces. This request exits in New York, United States:

curl -x gate.proxyfield.io:7000 -U "<login>-country-us-city-new_york:<password>" https://api.ipify.org

Every part after the login is optional, and every targeting costs the same per GB. Presets for sticky time are 1, 5, 10 and 30 minutes and 1, 3 and 6 hours.

More: proxy location targeting.

Anything with a proxy field works without code. Enter four values:

Where the fields are:

To change the location, change the username: <login>-country-de exits in Germany, with no other setting. To confirm it works, open https://api.ipify.org in the browser and compare the IP with yours, or test your proxy line in the proxy checker (up to 100 proxies per check; your list and results are not stored).

Any tool that accepts an HTTP, HTTPS or SOCKS5 proxy works with the gateway. In Python with Requests:

import requests

proxy = "http://<login>:<password>@gate.proxyfield.io:7000"
for _ in range(3):
    r = requests.get("https://api.ipify.org",
                     proxies={"http": proxy, "https": proxy}, timeout=30)
    print(r.text)  # a new proxy IP on each request

In Node.js 22 or later with undici (npm i undici):

import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent({
  uri: "http://gate.proxyfield.io:7000",
  token: "Basic " + Buffer.from("<login>:<password>").toString("base64"),
});
const res = await fetch("https://api.ipify.org", { dispatcher: agent });
console.log(await res.text());

SOCKS5 runs on the same host and port with the same username and password. With socks5h, the proxy also resolves the site's name, so your own DNS resolver does not see it:

curl --proxy socks5h://gate.proxyfield.io:7000 -U "<login>:<password>" https://api.ipify.org

# pip install "requests[socks]"
proxy = "socks5h://<login>:<password>@gate.proxyfield.io:7000"

Residential proxies also carry UDP over SOCKS5 (HTTP/3, QUIC). Choosing mobile instead of residential in the username: residential by default; add -mobile after the login for mobile IPs, as in <login>-mobile-country-us.

Guides for your tool: cURL, Python, Node.js, Scrapy, Selenium, Playwright and Puppeteer. Our 24/7 live chat also helps with setup and integration.

A username and password work from any machine and carry the location and session settings, so they suit laptops and changing networks. An IP allowlist authorizes your server's public IP address, so no credentials sit in your code; it suits fixed servers. With the IP allowlist, you connect to the port you set up in the dashboard instead of 7000, and the product, location and session are set per port there. The allowlist takes up to 100 IPv4 addresses per account, and one address can be on one account only. Both methods are compared in proxy authentication.

The dashboard shows real-time usage stats and the gigabytes you have left. Check the balance before a long job: nothing renews automatically, and what happens when traffic runs out mid-job is the open connection closes, and new connections get 402 Payment Required until you top up. A new purchase adds to what you have, and the traffic never expires.

Use the proxies on public pages only, and follow each site's terms. Some site categories are restricted to protect the network, including financial and government services; see the acceptable use policy. For a step-by-step diagnosis, see why is my proxy not working. Billing and account questions are in the help center.