Para desarrolladores
API ProxyHub
Todo lo que haces en el área de clientes lo puedes hacer desde tus scripts: lista de proxies con credenciales e IP actual, cambio de IP, renovación con el saldo, protocolo y rotación automática. Respuestas JSON, nada que instalar.
La clave
Crea la clave en Ajustes → API del área de clientes (hasta 5 por cuenta) y envíala en cada petición en la cabecera Authorization. La clave vale para todos tus proxies: trátala como una contraseña.
curl https://app.proxyhub.it/api/v1/proxies \
-H "Authorization: Bearer ph_XXXXXXXXXXXXXXXXXXXXXXXX"Dirección base
https://app.proxyhub.it/api/v1Endpoints
GET/proxies
Todos tus proxies, con credenciales, IP actual, estado y vencimiento.
GET/proxies/{port}
Un proxy.
PATCH/proxies/{port}
Cambia protocolo (http o socks5), usuario, contraseña o rotación automática (minutos: 5, 10, 15, 30, 60, 180, 360, 720, 1440, o null para apagarla). Envía solo los campos a cambiar.
curl -X PATCH https://app.proxyhub.it/api/v1/proxies/41170 \
-H "Authorization: Bearer ph_…" \
-H "Content-Type: application/json" \
-d '{"protocol": "socks5", "auto_rotate_minutes": 30}'POST/proxies/{port}/rotate
Nueva IP. Responde con la IP nueva.
POST/proxies/{port}/renew
Renueva pagando con el saldo: plan es daily, weekly o monthly (trial solo para un proxy de prueba); coupon opcional.
curl -X POST https://app.proxyhub.it/api/v1/proxies/41170/renew \
-H "Authorization: Bearer ph_…" \
-H "Content-Type: application/json" \
-d '{"plan": "monthly"}'GET/balance
Saldo en dólares.
Ejemplo de respuesta
{
"proxies": [
{
"port": 41170,
"host": "sfeshg.com",
"protocol": "http",
"username": "ph_e12734",
"password": "••••••••••",
"url": "http://ph_e12734:••••••••••@sfeshg.com:41170",
"status": "active",
"online": true,
"ip": "151.19.150.182",
"country": "it",
"carrier": "WindTre",
"plan": "monthly",
"expires_at": "2026-11-05T09:48:33.221Z",
"auto_renew": false,
"auto_rotate_minutes": null,
"rotation_url": "https://sfeshg.com/r/…",
"traffic_bytes": 1834021993,
"created_at": "2026-10-05T09:48:33.221Z"
}
]
}Límites
- 120 peticiones por minuto por cuenta.
- Cambio de IP: como máximo uno cada 2 minutos por teléfono (también cuentan el botón y el enlace de rotación).
- Renovaciones: 10 por minuto.
Errores
Los errores tienen siempre esta forma, con un código estable y un mensaje legible:
{"error": "too_soon", "message": "The IP was changed less than 2 minutes ago. Wait and retry."}Sin clave: el enlace de rotación
Solo para cambiar de IP no hace falta clave: cada proxy tiene un enlace de rotación en su ficha, para abrir o llamar desde tus scripts.
Desde el móvil: el bot de Telegram
Vincula Telegram desde el Perfil y usa /proxy, /ip, /rotate <puerto> y /balance en el chat con el bot.