API de proxies ISP

Utilice esta API para enumerar el pool de IP de proxies ISP y gestionar la lista blanca de IP de origen. Para el uso del proxy a nivel de protocolo (host:port, credenciales), consulte Productos → Proxies ISP.

Autenticación

Todos los endpoints se autentican con un parámetro de consulta api_token. Genere un token en el panel en Account → API Tokens.

?api_token=YOUR_API_TOKEN

El parámetro de ruta {membership} es el ID de su plan, que se muestra en el panel en la página del plan.

Listar proxies

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

Devuelve cada IP fija de su plan con el puerto y las credenciales compartidas. El mismo puerto (1337) y el mismo usuario/contraseña se aplican en todo el pool, solo cambia la IP.

Parameter	In	Required	Description
`membership`	path	yes	The plan ID
`api_token`	query	yes	Your account API token

Ejemplo:

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

Respuesta:

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

El campo country es el código ISO 3166-1 alpha-2 del país en el que se aprovisionó la IP. Los proxies ISP están disponibles en us, gb, fr, de, es y it. Los países en los que se encuentran sus IP se eligen una única vez en el momento de la compra y quedan fijados después; consulte Configuración de país.

IP de origen autorizadas

Añada a la lista blanca las IP de origen para que sus scrapers puedan omitir la autenticación HTTP Basic en cada solicitud. La lista blanca es a nivel de cuenta: cualquier origen en la lista blanca puede usar cualquier IP fija del pool.

Listar IP autorizadas

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

Parameter	In	Required	Description
`membership`	path	yes	The plan ID
`api_token`	query	yes	Your account API token

Respuesta:

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

Actualizar IP autorizadas

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

Reemplaza la lista de IP autorizadas con los valores proporcionados.

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

Ejemplo (codificado como formulario, con anulación de método):

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"

Comenzar

Proxies

APIs

Recursos