API de Proxies ISP

Use this API to enumerate your ISP proxy IP pool and manage the source-IP whitelist. Para uso do proxy em nível de protocolo (host:port, credenciais), consulte Produtos → ISP Proxies.

Autenticação

Todos os endpoints autenticam com um parâmetro de query api_token. Gere um token no painel em Account → API Tokens.

?api_token=YOUR_API_TOKEN

O parâmetro de caminho {membership} é o ID do seu plano, mostrado no painel na página do plano.

Listar proxies

GET https://shifter.io/api/v1/static-residential/{membership}/proxies

Retorna todo IP fixado no seu plano com a porta e as credenciais compartilhadas. A mesma porta (1337) e o mesmo usuário/senha se aplicam a todo o pool — apenas o IP muda.

Parameter	In	Required	Description
`membership`	path	yes	O ID do plano
`api_token`	query	yes	Seu token de API da conta

Exemplo:

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

Resposta:

{
  "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"
    }
  ]
}

O campo country é o código ISO 3166-1 alpha-2 do país em que o IP foi provisionado. Proxies ISP estão disponíveis em us, gb, fr, de, es e it. Os países em que seus IPs estão localizados são escolhidos uma vez no momento da compra e ficam fixos depois disso — veja Configuração de país.

IPs de origem autorizados

Coloque IPs de origem na whitelist para que seus scrapers possam pular a autenticação HTTP Basic em cada requisição. A whitelist vale para toda a conta — qualquer origem em whitelist pode usar qualquer IP fixado no pool.

Listar IPs autorizados

GET https://shifter.io/api/v1/static-residential/{membership}/authorized-ips

Parameter	In	Required	Description
`membership`	path	yes	O ID do plano
`api_token`	query	yes	Seu token de API da conta

Resposta:

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

Atualizar IPs autorizados

PUT https://shifter.io/api/v1/static-residential/{membership}/authorized-ips

Substitui a lista de IPs autorizados pelos valores fornecidos.

Parameter	In	Required	Description
`membership`	path	yes	O ID do plano
`api_token`	query	yes	Seu token de API da conta
`ips[]`	body	yes	Array de endereços IPv4 para whitelist

Exemplo (form-encoded, com method override):

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"

Começar

Proxies

APIs

Recursos