API Proxies résidentiels

Le produit Residential Proxies se configure par requête via le nom d’utilisateur de la gateway, il n’existe pas d’API de « gestion » par compte pour celui-ci. Ce que cette API vous offre, c’est un moyen d’énumérer les sélecteurs géographiques que vous pouvez insérer dans le nom d’utilisateur (country, region, city, asn) afin que votre outillage reste synchronisé avec ce qui est réellement disponible.

Note

Pour l’utilisation au niveau protocole, les sessions persistantes, la correspondance stricte et la liste complète des indicateurs, consultez Produits → Residential Proxies et Gateway & authentification.

Authentification

Tous les points de terminaison s’authentifient avec un paramètre de requête api_key. Générez une clé dans le panel sous Account → API Keys.

?api_key=YOUR_API_KEY

Lister les pays

GET https://shifter.io/api/v1/residential/geo/countries

Renvoie tous les pays disponibles pour le ciblage country-<iso2> sur la gateway Residential Proxies.

Parameter	In	Required	Description
api_key	query	yes	Votre clé API

Exemple :

curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"

Réponse :

[
  { "code": "us", "name": "United States" },
  { "code": "de", "name": "Germany" },
  { "code": "gb", "name": "United Kingdom" },
  { "code": "fr", "name": "France" }
]

Lister les régions

GET https://shifter.io/api/v1/residential/geo/regions

Renvoie les régions (états / provinces) disponibles pour le ciblage region-<slug> au sein d’un pays donné.

Parameter	In	Required	Description
api_key	query	yes	Votre clé API
country	query	yes	Code pays ISO 3166-1 alpha-2, par exemple us

Exemple :

curl "https://shifter.io/api/v1/residential/geo/regions?country=us&api_key=YOUR_API_KEY"

Réponse :

[
  { "slug": "california", "name": "California" },
  { "slug": "new_york",   "name": "New York" },
  { "slug": "texas",      "name": "Texas" }
]

Lister les villes

GET https://shifter.io/api/v1/residential/geo/cities

Renvoie les villes disponibles pour le ciblage city-<slug> au sein d’un pays (et éventuellement d’une région).

Parameter	In	Required	Description
api_key	query	yes	Votre clé API
country	query	yes	Code pays ISO 3166-1 alpha-2
region	query	no	Slug de région pour affiner les résultats

Exemple :

curl "https://shifter.io/api/v1/residential/geo/cities?country=us&region=california&api_key=YOUR_API_KEY"

Réponse :

[
  { "slug": "los_angeles",    "name": "Los Angeles" },
  { "slug": "san_francisco",  "name": "San Francisco" },
  { "slug": "san_diego",      "name": "San Diego" }
]

Lister les ASN

GET https://shifter.io/api/v1/residential/geo/asns

Renvoie les ASN disponibles pour le ciblage asn-<num> au sein d’un pays.

Parameter	In	Required	Description
api_key	query	yes	Votre clé API
country	query	yes	Code pays ISO 3166-1 alpha-2

Exemple :

curl "https://shifter.io/api/v1/residential/geo/asns?country=us&api_key=YOUR_API_KEY"

Réponse :

[
  { "asn": 7922, "name": "Comcast" },
  { "asn": 701,  "name": "Verizon" },
  { "asn": 22773, "name": "Cox Communications" }
]

Voir aussi

• Vue d’ensemble de Residential Proxies
• Ciblage géographique — comment insérer ces sélecteurs dans le nom d’utilisateur
• Authentification — authentification proxy vs. authentification de l’API de gestion