API des Proxies ISP

Utilisez cette API pour recenser votre pool d’IP proxy ISP et gérer la liste blanche des IP sources. Pour l’utilisation du proxy au niveau protocole (host:port, identifiants), consultez Produits → ISP Proxies.

Authentification

Tous les endpoints s’authentifient avec un paramètre de requête api_token. Générez un token dans le panel, sous Account → API Tokens.

?api_token=YOUR_API_TOKEN

Le paramètre de chemin {membership} correspond à l’ID de votre plan, indiqué dans le panel sur la page du plan.

Lister les proxies

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

Retourne chaque IP fixe de votre plan avec le port et les identifiants partagés. Le même port (1337) et le même identifiant/mot de passe s’appliquent à l’ensemble du pool ; seule l’IP change.

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

Exemple :

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

Réponse :

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

Le champ country correspond au code ISO 3166-1 alpha-2 du pays dans lequel l’IP a été provisionnée. Les proxies ISP sont disponibles dans les pays us, gb, fr, de, es et it. Les pays de vos IP sont choisis une seule fois au moment de l’achat, puis fixés définitivement, voir Configuration du pays.

IP sources autorisées

Placez des IP sources en liste blanche afin que vos scrapers puissent s’affranchir de l’authentification HTTP Basic à chaque requête. La mise en liste blanche s’applique à l’ensemble du compte : toute source en liste blanche peut utiliser n’importe quelle IP fixe du pool.

Lister les IP autorisées

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

Réponse :

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

Mettre à jour les IP autorisées

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

Remplace la liste des IP autorisées par les valeurs fournies.

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

Exemple (encodage de formulaire, avec surcharge de méthode) :

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"

Commencer

Proxies

APIs

Ressources