Authentication

Each Shifter product has its own auth model. Pick the section that matches your plan.

Residential Proxies

A single gateway, username and password on every request. No IP whitelist — the credentials are the sole auth.

p.shifter.io:443

The username also encodes routing options:

customer-USERNAME                                          # default (rotate, no geo)
customer-USERNAME-country-us                               # geo-target US
customer-USERNAME-country-us-region-california             # region/state-level
customer-USERNAME-country-us-city-new_york                 # city-level
customer-USERNAME-country-us-asn-7922                      # ASN-level (Comcast)
customer-USERNAME-sid-abc123                               # sticky session, default 120s TTL
customer-USERNAME-sid-abc123-ttl-600                       # sticky session, custom 600s TTL
customer-USERNAME-country-us-strict-true                   # 502 if no exact match

ISP Proxies

Every proxy connects through one host and port, over HTTP(S) or SOCKS5 with the same credentials:

isp.shifter.io:443

Each IP on your plan has its own username, which names its country, region, city and ISP (ASN) followed by a short hash, for example us-new_york-new_york-as701-Ksj25. The hash is case-sensitive. All usernames on a plan share one password, shown on the plan page in the panel; Reset Password there issues a new one. ISP Proxies do not support IP whitelisting: every request authenticates with a username and password.

# HTTP(S)
curl -x http://us-new_york-new_york-as701-Ksj25:PASSWORD@isp.shifter.io:443 \
  http://ip-info.com/json

# SOCKS5
curl --socks5-hostname us-new_york-new_york-as701-Ksj25:PASSWORD@isp.shifter.io:443 \
  http://ip-info.com/json

The plan page lists every username with its city and ISP, ready to copy or download as a .txt file. See ISP Proxies → Quickstart and Managing IPs.

Legacy pinned-IP plans. ISP plans bought before the current ISP Proxies launched connect to each IP directly on port 1337 (IP:1337), with a username and password or a whitelisted source IP. See Legacy ISP plans.

Legacy plans

Legacy port-list plans give you a fixed range of ports bound to your account. Each port has its own subdomain. Auth is by source IP only — whitelist your server’s IP in the panel, then connect to any port in your list:

apollo.p.shifter.io:10001
zeus.p.shifter.io:10002
cronos.p.shifter.io:10003

Manage authorized IPs in the panel or via the legacy management API.

API products (Web Scraping, SERP, Amazon)

Use an API key as a query parameter. Generate keys in the panel under each product’s API settings.

curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://example.com"

Never commit API keys to source control — use environment variables or a secrets manager.

Rate limits

Product	Limit	Overage
Residential Proxies	Bandwidth pool (GB/month)	Pay-per-GB Extra Traffic
ISP Proxies	Number of IPs on the plan	Unlimited bandwidth
Legacy plans	Per-port concurrency	Buy Extra Traffic in the panel
Web Scraping API	Credits/month	Upgrade to a larger plan
SERP API	Credits/month	Upgrade to a larger plan

Next steps

• Quickstart - send your first request
• Choosing a product - which product fits your use case