ISP Proxies API
Use this API to enumerate your ISP proxy IP pool and manage the source-IP whitelist. For protocol-level proxy usage (host:port, credentials), see Products → ISP Proxies.
Authentication
Section titled “Authentication”All endpoints authenticate with an api_token query parameter. Generate a token in the panel under Account → API Tokens.
?api_token=YOUR_API_TOKENThe {membership} path parameter accepts either form: the plan’s numeric ID (the number shown on the plan page in the panel) or its API ID (the short code at the end of the plan’s panel URL, for example https://shifter.io/panel/membership/DeeJ). Both resolve to the same plan.
List proxies
Section titled “List proxies”Returns every pinned IP in your plan, each as ip:port. The same port (1337) and the same username/password apply across the whole pool, so only the IP changes. The credentials are not part of this response; they are in the panel.
| Parameter | In | Required | Description |
|---|---|---|---|
membership | path | yes | The plan ID (numeric or API ID) |
api_token | query | yes | Your account API token |
Example:
curl "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/proxies?api_token=YOUR_API_TOKEN"Response:
{ "error": null, "code": 200, "data": [ "185.199.108.153:1337", "185.199.108.154:1337", "185.199.108.155:1337" ]}Each entry is ip:port. The port (1337) and the username/password are the same for every IP in the pool, only the IP changes; the credentials are in the panel under My Plans → ISP Proxies. ISP proxies are available in the US, Canada, UK, France, Germany, Spain and Italy. The countries your IPs sit in are chosen once at purchase and fixed afterward, see Country setup.
Authorized source IPs
Section titled “Authorized source IPs”Whitelist source IPs so your scrapers can skip HTTP Basic auth on each request. Whitelisting is account-wide — any whitelisted source can use any pinned IP in the pool.
List authorized IPs
Section titled “List authorized IPs”| Parameter | In | Required | Description |
|---|---|---|---|
membership | path | yes | The plan ID |
api_token | query | yes | Your account API token |
Response:
{ "error": null, "code": 200, "data": [ "198.51.100.10", "203.0.113.42" ]}Update authorized IPs
Section titled “Update authorized IPs”Replaces the list of authorized IPs with the values provided.
| Parameter | In | Required | Description |
|---|---|---|---|
membership | path | yes | The plan ID |
api_token | query | yes | Your account API token |
ips[] | body | yes | Array of IPv4 addresses to whitelist |
Example (form-encoded, with method override):
curl -X POST "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/authorized-ips?api_token=YOUR_API_TOKEN" \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "_method=PUT&ips[]=198.51.100.10&ips[]=203.0.113.42"