🎁 12 Stunden einmalig kostenlos testen · 🇩🇪 Echte deutsche 4G-Mobilfunk-IPs · Unbegrenzter Traffic · unbegrenzte Rotationen · ₿ Bezahlen mit Krypto oder Karte

API-Referenz

Kaufe, rotiere und verwalte deutsche 4G-Proxies programmatisch. Eine kleine, berechenbare REST-API — JSON rein, JSON raus.

Basis-URLhttps://api.proxion.io/v1

Alle Endpunkte sind unter /v1 versioniert und ausschließlich über HTTPS erreichbar.

Authentifizierung

Authentifiziere jede Anfrage mit einem API-Schlüssel im Authorization-Header. Schlüssel erstellst und widerrufst du im Dashboard unter API-Schlüssel. Schlüssel sind geheim — gib sie niemals im Client-Code preis.

http
Authorization: Bearer prx_live_xxx

Test-Schlüssel (prx_test_…) erzeugen Proxies, die sich identisch verhalten, aber nie berechnet werden.

Konventionen

Die gesamte API folgt wenigen einheitlichen Regeln — hast du einen Endpunkt aufgerufen, kennst du alle.

Überall JSON

Anfrage- und Antwort-Bodies sind UTF-8-JSON. Zeitstempel sind ISO-8601 in UTC (z. B. 2026-07-22T10:00:00Z).

Berechenbare Fehler

Fehler nutzen Standard-HTTP-Statuscodes und liefern { "error": { "code", "message" } }. Der code ist stabil und eignet sich zum Verzweigen; die message ist für Menschen lesbar.

Cursor-Pagination

List-Endpunkte akzeptieren limit (1–100) und starting_after=<id> und liefern { "data": [...], "has_more": bool }.

Rate-Limits

Jede authentifizierte Antwort enthält X-RateLimit-Limit und X-RateLimit-Remaining — 120 Anfragen pro Minute und Key. Bei Überschreitung folgt 429 mit Retry-After; wiederhole nach Ablauf des Fensters.

Das Proxy-Objekt

Beim Kauf eines Proxys erhältst du ein Proxy-Objekt. Es ist die einzige Ressource, mit der du arbeitest — die Zugangsdaten ändern sich nur, wenn du rotierst.

FeldTypBeschreibung
idstringEindeutige ID, z. B. px_a1b2c3d4.
planstringEines von 1d, 7d, 30d (oder trial).
statusstringactive solange nutzbar, expired nach Ablauf, released bei vorzeitiger Beendigung.
hoststringProxy-Hostname, z. B. de1.proxion.io.
portintegerProxy-Port für HTTP und SOCKS5.
usernamestringZugangsdaten für username:password-Auth.
passwordstringZugangsdaten für username:password-Auth.
protocolsstring[]Unterstützte Protokolle: ["http", "socks5"].
countrystringISO-Ländercode — immer DE.
os_profilestringTCP-Fingerprint-Profil: none, windows, macos, android, ios oder linux.
allowed_ipsstring[]IPs / CIDR-Bereiche, die ohne Benutzername:Passwort zugreifen dürfen (max. 20).
created_atstringZeitpunkt der Bereitstellung des Proxys.
expires_atstringZeitpunkt, zu dem der Zugang endet und die IP freigegeben wird.

Endpunkte

Acht Endpunkte decken den gesamten Lebenszyklus ab: Tarife entdecken, Proxy kaufen, prüfen, IP rotieren, Einstellungen ändern, verlängern und vorzeitig freigeben.

GET/v1/plans

Tarife auflisten

Liefert die verfügbaren Laufzeiten und ihren Preis in Cent. Keine Authentifizierung nötig.

Anfrage
curl https://api.proxion.io/v1/plans
Antwort
{
  "data": [
    { "plan": "1d",  "price_cents": 600  },
    { "plan": "7d",  "price_cents": 2900 },
    { "plan": "30d", "price_cents": 7900 }
  ]
}
POST/v1/proxies

Proxy kaufen

Stellt einen neuen deutschen 4G-Proxy im gewählten Tarif bereit und liefert ihn mit sofort nutzbaren Zugangsdaten zurück. Body: { "plan": "7d" }.

Anfrage
curl -X POST https://api.proxion.io/v1/proxies \
  -H "Authorization: Bearer prx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "7d" }'
Antwort
{
  "id": "px_a1b2c3d4",
  "plan": "7d",
  "status": "active",
  "host": "de1.proxion.io",
  "port": 24915,
  "username": "px_9f3a2",
  "password": "b7c1d9e0f2a4",
  "protocols": ["http", "socks5"],
  "country": "DE",
  "os_profile": "none",
  "allowed_ips": [],
  "created_at": "2026-07-22T10:00:00Z",
  "expires_at": "2026-07-29T10:00:00Z"
}
GET/v1/proxies

Deine Proxies auflisten

Liefert deine Proxies, neueste zuerst. Filtere mit ?status=active|expired und paginiere mit limit / starting_after.

Anfrage
curl "https://api.proxion.io/v1/proxies?status=active&limit=20" \
  -H "Authorization: Bearer prx_live_xxx"
Antwort
{
  "data": [ { "id": "px_a1b2c3d4", "status": "active", "...": "..." } ],
  "has_more": false
}
GET/v1/proxies/{id}

Proxy abrufen

Ruft einen einzelnen Proxy per id ab, inklusive aktueller Zugangsdaten und Ablaufdatum.

Anfrage
curl https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
  -H "Authorization: Bearer prx_live_xxx"
Antwort
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "host": "de1.proxion.io",
  "port": 24915,
  "expires_at": "2026-07-29T10:00:00Z"
}
POST/v1/proxies/{id}/rotate

IP rotieren

Weist dem Proxy eine frische Mobil-IP zu und behält dieselben Zugangsdaten. Oder verbinde dich einfach weiter, um die aktuelle IP zu halten.

Anfrage
curl -X POST https://api.proxion.io/v1/proxies/px_a1b2c3d4/rotate \
  -H "Authorization: Bearer prx_live_xxx"
Antwort
{
  "id": "px_a1b2c3d4",
  "host": "de3.proxion.io",
  "port": 28104,
  "username": "px_9f3a2",
  "password": "b7c1d9e0f2a4"
}
POST/v1/proxies/{id}/extend

Proxy verlängern

Fügt einem aktiven Proxy eine weitere Laufzeit hinzu, sodass IP und Zugangsdaten über den ursprünglichen Ablauf hinaus erhalten bleiben. Body: { "plan": "7d" }.

Anfrage
curl -X POST https://api.proxion.io/v1/proxies/px_a1b2c3d4/extend \
  -H "Authorization: Bearer prx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "7d" }'
Antwort
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "expires_at": "2026-08-05T10:00:00Z"
}
PATCH/v1/proxies/{id}

Einstellungen ändern

Setzt das TCP-OS-Fingerprint-Profil (none, windows, macos, android, ios, linux) und/oder die IP-Whitelist. Weggelassene Felder bleiben unverändert; allowed_ips ersetzt die ganze Liste.

Anfrage
curl -X PATCH https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
  -H "Authorization: Bearer prx_live_xxx" \
  -d '{ "os_profile": "windows", "allowed_ips": ["203.0.113.7", "10.0.0.0/24"] }'
Antwort
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "os_profile": "windows",
  "allowed_ips": ["203.0.113.7", "10.0.0.0/24"]
}
DELETE/v1/proxies/{id}

Proxy freigeben

Beendet einen Proxy vorzeitig und gibt seine IP frei. Unwiderruflich; keine Erstattung für die Restzeit.

Anfrage
curl -X DELETE https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
  -H "Authorization: Bearer prx_live_xxx"
Antwort
{
  "id": "px_a1b2c3d4",
  "status": "released"
}

Mit einem Proxy verbinden

Nutze host, port, username und password mit jedem HTTP- oder SOCKS5-Client. Dieselben Zugangsdaten funktionieren für beide Protokolle.

bash
# HTTP
curl -x http://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
  https://api.ipify.org
# → 185.XX.XX.XX (DE · 4G)

# SOCKS5
curl -x socks5://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
  https://api.ipify.org

Schnellstart

Kaufe einen 7-Tage-Proxy und sende deine erste Anfrage in zwei Aufrufen durch ihn hindurch.

bash
# 1. Buy a 7-day proxy
curl -X POST https://api.proxion.io/v1/proxies \
  -H "Authorization: Bearer prx_live_xxx" \
  -d '{ "plan": "7d" }'

# 2. Route a request through it
curl -x http://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
  https://api.ipify.org
Schreib uns