Skip to content
Login Sign up

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_TOKEN

The {membership} path parameter is your plan ID, shown in the panel on the plan page.

List proxies

Section titled “List proxies”
GET https://shifter.io/api/v1/static-residential/{membership}/proxies

Returns every pinned IP in your plan with the shared port and credentials. The same port (1337) and the same username/password apply across the whole pool — only the IP changes.

ParameterInRequiredDescription
membershippathyesThe plan ID
api_tokenqueryyesYour account API token

Example:

Terminal window
curl "https://shifter.io/api/v1/static-residential/MEMBERSHIP_ID/proxies?api_token=YOUR_API_TOKEN"

Response:

{
  "proxies": [
    {
      "ip": "185.199.108.153",
      "port": 1337,
      "username": "pool-xyz",
      "password": "...",
      "country": "us",
      "asn": 7922,
      "isp": "Comcast",
      "assigned_at": "2026-01-15T12:03:44Z"
    },
    {
      "ip": "185.199.108.154",
      "port": 1337,
      "username": "pool-xyz",
      "password": "...",
      "country": "gb",
      "asn": 5089,
      "isp": "Virgin Media",
      "assigned_at": "2026-01-15T12:03:44Z"
    }
  ]
}

The country field is the ISO 3166-1 alpha-2 code of the country the IP was provisioned in. ISP proxies are available in us, gb, fr, de, es, and it. The countries your IPs are in are chosen once at purchase time 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”
GET https://shifter.io/api/v1/static-residential/{membership}/authorized-ips
ParameterInRequiredDescription
membershippathyesThe plan ID
api_tokenqueryyesYour account API token

Response:

{
  "ips": ["198.51.100.10", "203.0.113.42"]
}

Update authorized IPs

Section titled “Update authorized IPs”
PUT https://shifter.io/api/v1/static-residential/{membership}/authorized-ips

Replaces the list of authorized IPs with the values provided.

ParameterInRequiredDescription
membershippathyesThe plan ID
api_tokenqueryyesYour account API token
ips[]bodyyesArray of IPv4 addresses to whitelist

Example (form-encoded, with method override):

Terminal window
curl -X POST "https://shifter.io/api/v1/static-residential/MEMBERSHIP_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"

See also

Section titled “See also”