Gateway & authentication
Every Residential Proxies request goes through one endpoint. You authenticate on each request with your username and password.
Endpoint
Section titled “Endpoint”| Field | Value |
|---|---|
| Host | p.shifter.io |
| Port | 443 |
| Protocols | HTTP(S), SOCKS5 |
Use the same host and port regardless of location, protocol, or session mode. Targeting and session options are encoded in the username, not in a different endpoint.
Regional entry points
Section titled “Regional entry points”p.shifter.io connects you to the nearest of our eight regions and fails over automatically if one is unavailable. You can also connect through one region directly:
| Region | Host |
|---|---|
| Frankfurt | fra.p.shifter.io |
| Amsterdam | ams.p.shifter.io |
| London | lon.p.shifter.io |
| New York | nyc.p.shifter.io |
| Toronto | tor.p.shifter.io |
| Singapore | sgp.p.shifter.io |
| Bangalore | blr.p.shifter.io |
| Sydney | syd.p.shifter.io |
All hosts use port 443 and the same username, password and flags. The entry point only decides where your connection enters our network; the exit IP still comes from the country you target.
Use a regional host when several machines or services share one sticky session (see Sessions), or when a long session must never change IP. Pick the region closest to where most of your traffic runs, and use the same host in every tool that shares the session. You can also choose it in the panel under Entry Point on your Residential Proxies plan; the connection details there update to match.
Authentication
Section titled “Authentication”Your username and password are shown in the panel under Residential Proxies.
curl -x customer-USERNAME-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \ https://ipinfo.io/jsonExtend the username with flags to express targeting and session intent:
customer-USERNAME-country-us-city-new_york-sid-9f3a2b7c # default 120s stickycustomer-USERNAME-country-us-city-new_york-sid-9f3a2b7c-ttl-600 # custom 600s stickyFlag order does not matter. ttl is optional and only valid alongside sid. The password stays the same regardless of flags.
Common errors
Section titled “Common errors”| Response | Likely cause |
|---|---|
407 Proxy Authentication Required | Username or password wrong, or an unknown flag (e.g. bad country code). |
502 Bad Gateway | No IPs match your filter at this moment. Broaden the filter, retry, or remove strict-true to allow a broader fallback. |
509 Bandwidth Limit Exceeded | Plan bandwidth exhausted with Extra Traffic disabled. |
| Connection refused | You are pointing at the legacy port-based host. Switch to p.shifter.io:443. |
- Geo-targeting, country, city, ASN syntax.
- Sessions, sticky vs rotating.