Zum Inhalt springen
ProxyHub
Anmelden

Für Entwickler

ProxyHub API

Alles, was Sie im Kundenbereich tun, geht auch aus Ihren Skripten: Liste der Proxys mit Zugangsdaten und aktueller IP, IP-Wechsel, Verlängerung vom Guthaben, Protokoll und automatische Rotation. JSON-Antworten, nichts zu installieren.

Der Schlüssel

Erstellen Sie den Schlüssel unter Einstellungen → API im Kundenbereich (bis zu 5 pro Konto) und senden Sie ihn bei jeder Anfrage im Authorization-Header. Der Schlüssel gilt für alle Ihre Proxys: behandeln Sie ihn wie ein Passwort.

curl https://app.proxyhub.it/api/v1/proxies \
  -H "Authorization: Bearer ph_XXXXXXXXXXXXXXXXXXXXXXXX"

Basisadresse

https://app.proxyhub.it/api/v1

Endpunkte

GET/proxies

Alle Ihre Proxys mit Zugangsdaten, aktueller IP, Status und Ablauf.

GET/proxies/{port}

Ein Proxy.

PATCH/proxies/{port}

Ändert Protokoll (http oder socks5), Benutzer, Passwort oder automatische Rotation (Minuten: 5, 10, 15, 30, 60, 180, 360, 720, 1440, oder null zum Ausschalten). Senden Sie nur die Felder, die sich ändern.

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

Neue IP. Antwortet mit der neuen IP.

POST/proxies/{port}/renew

Verlängert vom Guthaben: plan ist daily, weekly oder monthly (trial nur für einen Test-Proxy); coupon optional.

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

Guthaben in US-Dollar.

Beispielantwort

{
  "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"
    }
  ]
}

Limits

  • 120 Anfragen pro Minute und Konto.
  • IP-Wechsel: höchstens einer alle 2 Minuten pro Telefon (Button und Rotationslink zählen mit).
  • Verlängerungen: 10 pro Minute.

Fehler

Fehler haben immer diese Form, mit stabilem Code und lesbarer Meldung:

{"error": "too_soon", "message": "The IP was changed less than 2 minutes ago. Wait and retry."}
401 unauthorizedSchlüssel fehlt, unbekannt oder widerrufen
404 not_foundkein Proxy mit diesem Port in Ihrem Konto
400 invalidfalsche Parameter (die Meldung sagt welche)
402 insufficient_balanceGuthaben reicht nicht für die Verlängerung
403 expiredProxy abgelaufen oder gesperrt: zuerst verlängern
429 too_soonIP wurde vor weniger als 2 Minuten gewechselt
429 rate_limitedzu viele Anfragen
502 backendder Proxy-Server hat nicht geantwortet: gleich erneut versuchen

Ohne Schlüssel: der Rotationslink

Nur für den IP-Wechsel braucht es keinen Schlüssel: jeder Proxy hat in seiner Ansicht einen Rotationslink, den Sie aus Ihren Skripten öffnen oder aufrufen können.

Vom Handy: der Telegram-Bot

Verbinden Sie Telegram im Profil und nutzen Sie /proxy, /ip, /rotate <Port> und /balance im Chat mit dem Bot.

Schlüssel erstellen