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.
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.
| Feld | Typ | Beschreibung |
|---|
id | string | Eindeutige ID, z. B. px_a1b2c3d4. |
plan | string | Eines von 1d, 7d, 30d (oder trial). |
status | string | active solange nutzbar, expired nach Ablauf, released bei vorzeitiger Beendigung. |
host | string | Proxy-Hostname, z. B. de1.proxion.io. |
port | integer | Proxy-Port für HTTP und SOCKS5. |
username | string | Zugangsdaten für username:password-Auth. |
password | string | Zugangsdaten für username:password-Auth. |
protocols | string[] | Unterstützte Protokolle: ["http", "socks5"]. |
country | string | ISO-Ländercode — immer DE. |
os_profile | string | TCP-Fingerprint-Profil: none, windows, macos, android, ios oder linux. |
allowed_ips | string[] | IPs / CIDR-Bereiche, die ohne Benutzername:Passwort zugreifen dürfen (max. 20). |
created_at | string | Zeitpunkt der Bereitstellung des Proxys. |
expires_at | string | Zeitpunkt, 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.
Tarife auflisten
Liefert die verfügbaren Laufzeiten und ihren Preis in Cent. Keine Authentifizierung nötig.
curl https://api.proxion.io/v1/plans
{
"data": [
{ "plan": "1d", "price_cents": 600 },
{ "plan": "7d", "price_cents": 2900 },
{ "plan": "30d", "price_cents": 7900 }
]
}
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" }.
curl -X POST https://api.proxion.io/v1/proxies \
-H "Authorization: Bearer prx_live_xxx" \
-H "Content-Type: application/json" \
-d '{ "plan": "7d" }'
{
"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"
}
Deine Proxies auflisten
Liefert deine Proxies, neueste zuerst. Filtere mit ?status=active|expired und paginiere mit limit / starting_after.
curl "https://api.proxion.io/v1/proxies?status=active&limit=20" \
-H "Authorization: Bearer prx_live_xxx"
{
"data": [ { "id": "px_a1b2c3d4", "status": "active", "...": "..." } ],
"has_more": false
}
Proxy abrufen
Ruft einen einzelnen Proxy per id ab, inklusive aktueller Zugangsdaten und Ablaufdatum.
curl https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
-H "Authorization: Bearer prx_live_xxx"
{
"id": "px_a1b2c3d4",
"status": "active",
"host": "de1.proxion.io",
"port": 24915,
"expires_at": "2026-07-29T10:00:00Z"
}
POST/v1/proxies/{id}/rotateIP 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.
curl -X POST https://api.proxion.io/v1/proxies/px_a1b2c3d4/rotate \
-H "Authorization: Bearer prx_live_xxx"
{
"id": "px_a1b2c3d4",
"host": "de3.proxion.io",
"port": 28104,
"username": "px_9f3a2",
"password": "b7c1d9e0f2a4"
}
POST/v1/proxies/{id}/extendProxy 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" }.
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" }'
{
"id": "px_a1b2c3d4",
"status": "active",
"expires_at": "2026-08-05T10:00:00Z"
}
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.
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"] }'
{
"id": "px_a1b2c3d4",
"status": "active",
"os_profile": "windows",
"allowed_ips": ["203.0.113.7", "10.0.0.0/24"]
}
Proxy freigeben
Beendet einen Proxy vorzeitig und gibt seine IP frei. Unwiderruflich; keine Erstattung für die Restzeit.
curl -X DELETE https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
-H "Authorization: Bearer prx_live_xxx"
{
"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.
# 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.
# 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