Esta guía muestra cómo crear una lista de proxies residenciales con geo-segmentación y rotación.
Cada solicitud usa tu clave API personal del panel de tu cuenta (cómo obtener tu clave API). En los ejemplos siguientes, reemplaza YOUR_API_KEY por tu propia clave. Para pagar con el saldo de tu cuenta, usa paymentId = 1.
Paso 1 — Comprueba el paquete
Confirma que el paquete residencial está activo y tiene tráfico. Copia el package_key.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
Respuesta
{
"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": []
}
Paso 2 — Obtén las ubicaciones disponibles
Descarga las ubicaciones disponibles (país / región / ciudad / ISP) para conocer los valores GEO exactos. La respuesta es un JSON/ZIP con el árbol GEO completo.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/geo
Respuesta
[
{
"code": "US",
"name": "United States",
"regions": [
{ "name": "Washington", "cities": [ { "name": "Garfield", "isps": [ "FIRST-STEP" ] } ] }
]
}
]
Paso 3 — Crea la lista
Crea la lista con un título, el objeto geo (del paso 2), la configuración de export y un valor de rotación.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Cuerpo de la solicitud
Nombre | Tipo | Descripción |
title | String | Nombre de la lista. |
whitelist (opcional) | String | IP para autorización. Déjalo en blanco para usar usuario:contraseña. |
geo | object | Objeto con |
export | object | Objeto: |
rotation | Number | Rotación: |
Ejemplo
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Respuesta
{
"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": []
}
Paso 4 — Comprueba la lista nueva
Lista tus listas residenciales para confirmar la creación y obtener los datos de conexión.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
Respuesta
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}