Per sviluppatori
API ProxyHub
Tutto quello che fai nell'area clienti lo puoi fare dai tuoi script: elenco dei proxy con credenziali e IP attuale, cambio IP, rinnovo dal saldo, protocollo e rotazione automatica. Risposte JSON, nessuna libreria da installare.
La chiave
Crea la chiave in Impostazioni → API nell'area clienti (fino a 5 per account) e mandala in ogni richiesta nell'header Authorization. La chiave vale per tutti i tuoi proxy: trattala come una password.
curl https://app.proxyhub.it/api/v1/proxies \
-H "Authorization: Bearer ph_XXXXXXXXXXXXXXXXXXXXXXXX"Indirizzo base
https://app.proxyhub.it/api/v1Endpoint
GET/proxies
Tutti i tuoi proxy, con credenziali, IP attuale, stato e scadenza.
GET/proxies/{port}
Un proxy.
PATCH/proxies/{port}
Cambia protocollo (http o socks5), utente, password o rotazione automatica (minuti: 5, 10, 15, 30, 60, 180, 360, 720, 1440, oppure null per spegnerla). Invia solo i campi da cambiare.
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
Nuovo IP. Risponde con l'IP nuovo.
POST/proxies/{port}/renew
Rinnova pagando dal saldo: plan è daily, weekly o monthly (trial solo per un proxy di prova); coupon facoltativo.
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 in dollari.
Esempio di risposta
{
"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"
}
]
}Limiti
- 120 richieste al minuto per account.
- Cambio IP: al massimo uno ogni 2 minuti per telefono (vale anche per il pulsante e il link di rotazione).
- Rinnovi: 10 al minuto.
Errori
Gli errori hanno sempre questa forma, con un codice stabile e un messaggio leggibile:
{"error": "too_soon", "message": "The IP was changed less than 2 minutes ago. Wait and retry."}Senza chiave: il link di rotazione
Per il solo cambio IP non serve la chiave: ogni proxy ha un link di rotazione nella sua scheda, da aprire o chiamare dai tuoi script.
Dal telefono: il bot Telegram
Collega Telegram dal Profilo e usa i comandi /proxy, /ip, /rotate <porta> e /balance in chat con il bot.