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} aceita ambas as formas: o ID numérico do plano (o número exibido na página do plano no painel) ou o seu ID de API (o código curto no final do URL do plano no painel, por exemplo https://shifter.io/panel/membership/DeeJ). Ambos identificam o mesmo 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 (numérico ou ID de API)
`api_token`	query	yes	Seu token de API da conta

Exemplo:

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

Resposta:

{
  "error": null,
  "code": 200,
  "data": [
    "185.199.108.153:1337",
    "185.199.108.154:1337",
    "185.199.108.155:1337"
  ]
}

Cada entrada tem o formato ip:port. A porta (1337) e o utilizador/palavra-passe são iguais para todos os IP do conjunto: apenas o IP muda; as credenciais estão no painel em My Plans → ISP Proxies. Os proxies ISP estão disponíveis nos EUA, Canadá, Reino Unido, França, Alemanha, Espanha e Itália. Os países dos seus IP são escolhidos uma vez na compra e ficam fixos, consulte 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:

{
  "error": null,
  "code": 200,
  "data": [
    "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/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"

Começar

Proxies

APIs

Recursos