Esta guía muestra cómo comprar nuevos proxies a través de la API desde cero: comprobar la disponibilidad, calcular el precio, realizar el pedido y obtener las IP compradas.
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.
⚠️ El paso del pedido cobra de tu saldo. Comprueba siempre primero el coste en el paso de cálculo.
El flujo de un vistazo
Comprueba tu saldo.
Consulta qué se puede pedir (país, periodo).
Elige un método de pago (o usa tu saldo).
Calcula el precio.
Realiza el pedido.
Obtén los proxies comprados.
Paso 1 — Comprueba tu saldo
Asegúrate de tener saldo suficiente para la compra.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get
Respuesta
{
"status": "success",
"data": { "summ": 10 },
"errors": []
}
Paso 2 — Consulta qué se puede pedir
La Reference List devuelve todo lo necesario para hacer un pedido: países, periodos, objetivos, operadores y rotaciones (para móvil). Copia el countryId y el periodId que necesites.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/{type}
Parámetros de ruta
Nombre | Valor | Descripción |
type |
| El tipo de proxy (ipv4, ipv6, mobile, isp, mix, mix_isp). |
Ejemplo
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/ipv4
Respuesta
{
"status": "success",
"data": {
"items": [
{
"country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
"period": [ { "id": "1m", "name": "1 month" } ]
}
]
},
"errors": []
}
Paso 3 — Elige un método de pago
Lista los sistemas de pago disponibles y copia el id que quieras como paymentId. Para pagar con el saldo, usa simplemente paymentId = 1.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list
Respuesta
{
"status": "success",
"data": {
"items": [
{ "id": "30", "name": "Visa / MasterCard" },
{ "id": "41", "name": "USDT (TRC-20)" },
{ "id": "29", "name": "PayPal" },
{ "id": "35", "name": "Binance" }
]
},
"errors": []
}
Paso 4 — Calcula el precio
Calcula el precio del pedido antes de comprar. Los descuentos por volumen y periodo de alquiler se aplican igual que en la web. Este paso no cobra nada.
Los campos del cuerpo dependen del tipo de proxy. Los campos comunes están abajo; para IPv6 envía también protocol, para móvil operatorId + rotationId, para residencial usa tarifId: todo de la Reference List.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc
Cuerpo de la solicitud
Nombre | Tipo | Descripción |
countryId | Number | ID del país de la Reference List (paso 2). |
periodId | String | ID del periodo de alquiler de la Reference List. |
quantity | Number | El número de proxies a pedir. |
paymentId | Number | ID del sistema de pago. |
coupon (opcional) | String | Un código de cupón, si tienes uno. |
authorization (opcional) | String | Método de autorización. Déjalo en blanco para usar usuario:contraseña. |
customTargetName (opcional) | String | Un nombre de objetivo personalizado, si es necesario. |
Ejemplo
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc
Respuesta — shows the total, your balance, the discount and the per-proxy price:
{
"status": "success",
"data": {
"warning": "",
"balance": 2000,
"total": 9,
"quantity": 5,
"currency": "USD",
"discount": 0.45,
"price": 1.8
},
"errors": []
}
Paso 5 — Realiza el pedido (cobra de tu saldo)
Cuando el precio calculado sea correcto, realiza el pedido. Este paso cobra de tu saldo. Usa los mismos parámetros que en el paso 4. Copia el orderId de la respuesta.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make
Cuerpo de la solicitud
Nombre | Tipo | Descripción |
countryId | Number | ID del país de la Reference List (paso 2). |
periodId | String | ID del periodo de alquiler de la Reference List. |
quantity | Number | El número de proxies a pedir. |
paymentId | Number | ID del sistema de pago. |
coupon (opcional) | String | Un código de cupón, si tienes uno. |
authorization (opcional) | String | Método de autorización. Déjalo en blanco para usar usuario:contraseña. |
generateAuth (opcional) | String | Y/N — crear autorización personalizada (por defecto N). |
Ejemplo
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make
Respuesta — returns the new order ID and your updated balance:
{
"status": "success",
"data": {
"orderId": 2426273,
"total": 16.2,
"listBaseOrderNumbers": [ "3388485_57471911" ],
"balance": 1776.88
},
"errors": []
}
Paso 6 — Obtén los proxies comprados
Obtén los proxies comprados. Filtra por el orderId del paso anterior para ver exactamente lo adquirido.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
Respuesta
{
"status": "success",
"data": {
"items": [
{
"id": "0678564",
"order_id": "123456",
"ip": "31.6.33.97",
"protocol": "HTTP",
"port_http": 12345,
"port_socks": 12345,
"login": "ruht5734hg",
"password": "gou5h437g",
"country": "Belgium",
"country_alpha3": "BEL",
"status_type": "ACTIVE",
"date_start": "23.06.2024",
"date_end": "23.07.2024"
}
]
},
"errors": []
}
Referencia completa de la API
Order actions — lista de referencia, cálculo y pedido
Retrieve active proxy — lista tus proxies
Balance — saldo y sistemas de pago