Ce guide explique comment créer une liste de proxys résidentiels géociblée avec rotation.
Chaque requête utilise votre clé API personnelle depuis le tableau de bord de votre compte (comment obtenir votre clé API). Dans les exemples ci-dessous, remplacez YOUR_API_KEY par votre propre clé. Pour payer avec le solde de votre compte, utilisez paymentId = 1.
Étape 1 — Vérifiez le package
Vérifiez que le package résidentiel est actif et qu'il reste du trafic. Copiez le package_key.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
Réponse
{
"status": "success",
"data": {
"rotation": 60,
"traffic_limit": "7516192768",
"traffic_usage": "10",
"traffic_left": "10",
"package_key": "1234567890abcdefedcb",
"expired_at": "d.m.Y",
"is_active": true,
"tarif_id": 2
},
"errors": []
}
Étape 2 — Récupérez les emplacements disponibles
Téléchargez les emplacements disponibles (pays / région / ville / FAI) pour connaître les valeurs GEO exactes. La réponse est un JSON/ZIP avec l'arbre GEO complet.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/geo
Réponse
[
{
"code": "US",
"name": "United States",
"regions": [
{ "name": "Washington", "cities": [ { "name": "Garfield", "isps": [ "FIRST-STEP" ] } ] }
]
}
]
Étape 3 — Créez la liste
Créez la liste avec un titre, l'objet geo (de l'étape 2), les paramètres export et une valeur de rotation.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Corps de la requête
Nom | Type | Description |
title | String | Nom de la liste. |
whitelist (optionnel) | String | IP pour l'autorisation. Laissez vide pour identifiant:mot de passe. |
geo | object | Objet avec |
export | object | Objet : |
rotation | Number | Rotation : |
Exemple
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Réponse
{
"status": "success",
"data": {
"id": 561,
"title": "US Washington Garfield FIRST-STEP",
"login": "3c8aa1d4",
"password": "AZT62Dx3",
"geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
"export": { "ports": 10000, "ext": "txt" }
},
"errors": []
}
Étape 4 — Vérifiez la nouvelle liste
Listez vos listes résidentielles pour confirmer la création et récupérer les détails de connexion.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
Réponse
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}