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

Each pinned IP uses the same port (1337) — only the IP changes between proxies. Pick one of two auth modes for your plan in the panel under ISP Proxies.

Authorized source IP — whitelist your server’s IP in the panel and connect without credentials:

185.199.108.153:1337
185.199.108.154:1337
185.199.108.155:1337

Username + password — use anywhere, no whitelist required. The panel emits one line per IP in this format:

185.199.108.153:1337:USERNAME:PASSWORD
185.199.108.154:1337:USERNAME:PASSWORD
185.199.108.155:1337:USERNAME:PASSWORD

See ISP Proxies → Quickstart and Managing IPs.

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	Per-IP concurrency	Unlimited bandwidth, no overage
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