← Docs / Proxies
Proxy formats for bots and automation tools
Most bots and automation tools take a proxy as one line of text. They differ in the order of the parts. This page gives our proxy in each common format, so you can paste the one your tool asks for.
The four parts
| Part | Value |
|---|---|
| Host | proxy.privatebyte.com |
| Port | 3128 for HTTP, 1080 for SOCKS5 |
| Username | Your proxy API key |
| Password | A tier and its options, for example standard_country-US |
Common formats
Replace YOUR_KEY with your key and PASSWORD with your tier string.
| Format the tool asks for | What to paste |
|---|---|
host:port:user:pass |
proxy.privatebyte.com:3128:YOUR_KEY:PASSWORD |
user:pass@host:port |
YOUR_KEY:[email protected]:3128 |
user:pass:host:port |
YOUR_KEY:PASSWORD:proxy.privatebyte.com:3128 |
| URL, HTTP | http://YOUR_KEY:[email protected]:3128 |
| URL, SOCKS5 | socks5://YOUR_KEY:[email protected]:1080 |
The password contains underscores and hyphens but no colons or @ signs, so it is safe in every format above.
One IP per task
Bots usually run many tasks at once. Give each task its own session name so each keeps its own IP:
proxy.privatebyte.com:3128:YOUR_KEY:standard_country-US_session-task1_ttl-30
proxy.privatebyte.com:3128:YOUR_KEY:standard_country-US_session-task2_ttl-30
proxy.privatebyte.com:3128:YOUR_KEY:standard_country-US_session-task3_ttl-30
Without a session, each request can leave from a different IP. See sticky sessions and rotating explained.
Which tier
standardfor rotating or timed residential IPs. Start here.sticky_cleanwhen a task has several steps on a strict site.mobilewhen the tool needs a carrier IP.datacenterfor high-volume work on sites that accept datacenter addresses. It is US only during the beta and has no sessions.
Test one line first
Before you load a full list into a tool, test one line with curl:
curl --proxy 'http://YOUR_KEY:[email protected]:3128' https://api.ipify.org
It should print an IP address that is not your own. If it fails, see proxy troubleshooting.
What we do not allow
Follow our acceptable use policy and the terms of the sites you use. Using software to get round purchase limits on event tickets is against the law in the United States and the United Kingdom, and we do not allow it on our network. No proxy guarantees that a site will accept a request or complete a purchase.
Next
Proxy credit is billed per GB and never expires. See the tiers and rates, or the connection format for every option.
Related
Still stuck? Open a ticket — tell us what was missing and the article gets fixed.