Proxy-API-Dokumentation: Proxy-Listen per REST API abrufen

Was kann ich mit der API tun?

API eignet sich, wenn Programme selbst aktuelle Listen abrufen sollen - z.B. bei Crawler-Start, Planwechsel oder Ablauf. Die API liefert dieselben Daten wie manueller Download im Dashboard.

Die API ist schreibgeschützt. Sie unterstützt die Überprüfung des Guthabens, die Auflistung von Plänen und die Abfrage von Proxy-Listen. Zahlungen und Käufe erfolgen im Dashboard. Alle Antworten sind UTF-8 und Datumsangaben im ISO 8601 UTC-Format.

Wie erstelle und sende ich einen API-Schlüssel?

Erstellen Sie einen API-Schlüssel auf der API-Schlüssel-Seite im Dashboard. Der Schlüssel beginnt mit spx_ und ist 44 Zeichen lang. Er wird nur einmal beim Erstellen angezeigt. Da nur der Hash des Schlüssels auf dem Server gespeichert wird, können Sie bei Verlust einfach einen neuen Schlüssel erstellen, wodurch der vorherige Schlüssel sofort ungültig wird.

Fügen Sie jeder Anfrage den API-Schlüssel als Bearer-Token im Authorization-Header hinzu. Schlüssel in der URL werden nicht akzeptiert. Fehlende oder falsche Schlüssel führen zu 401 Unauthorized.

curl -H "Authorization: Bearer spx_your_api_key" https://socks5proxy.io/api/v1/account

Guthaben- und Kontoinformationen abrufen: GET /account

Gibt den Kontocode, das Guthaben, die Anzahl der aktiven Pläne und die Anzahl der Proxies zurück. Das Guthaben wird auf zwei Dezimalstellen genau angezeigt (USD).

curl -H "Authorization: Bearer spx_your_api_key" https://socks5proxy.io/api/v1/account

{
  "code": "S5-7KQ2-M8PX-4HDA",
  "balance": "125.40",
  "currency": "USD",
  "active_plans": 2,
  "proxies": 125,
  "created_at": "2026-10-22T08:15:02.114Z"
}

Tarifliste abrufen: GET /plans

Gibt die gekauften Pläne in der Reihenfolge der neuesten zuerst zurück. Der Status ist entweder active (in Benutzung), expired (abgelaufen) oder canceled (storniert). Die ID ist der Plancode (beginnt mit P-) und kann als plan-Wert in /proxies verwendet werden.

{
  "plans": [
    {
      "id": "P-8WQ4C-NM2KT",
      "product": "dc-private",
      "product_name": "Private Datacenter Proxy",
      "ips": 100,
      "months": 1,
      "country": "us",
      "status": "active",
      "amount": "49.40",
      "created_at": "2026-10-22T08:20:11.002Z",
      "expires_at": "2026-11-22T08:20:11.002Z"
    }
  ]
}

Proxy-Listenabfrage: GET /proxies

Gibt die Proxies Ihres aktuellen Plans als JSON zurück. Enthält für jeden Proxy Adresse, HTTP-Port, SOCKS5-Port, Benutzername, Passwort, Land, Stadt, Plancode und Ablaufzeit.

Sie können nach country (zweistelliger Ländercode, z.B. us) und plan (Tarifcode) filtern. Der protocol-Wert wird in der Antwort angezeigt, und das JSON enthält beide Ports.

curl -H "Authorization: Bearer spx_your_api_key" \
  "https://socks5proxy.io/api/v1/proxies?country=us&protocol=socks5"

{
  "count": 1,
  "protocol": "socks5",
  "proxies": [
    {
      "host": "198.51.100.23",
      "http_port": 8231,
      "socks5_port": 1080,
      "username": "spx_k2m8qa",
      "password": "q7rbx2wd9n",
      "country": "us",
      "city": "New York",
      "plan": "P-8WQ4C-NM2KT",
      "product": "dc-private",
      "product_name": "Private Datacenter Proxy",
      "expires_at": "2026-11-22T08:20:11.002Z"
    }
  ]
}

Liste herunterladen: GET /proxies/download

Proxy-Listen werden zeilenweise zurückgegeben, mit SOCKS5- oder HTTP-Ports je nach protocol. format=url fügt das entsprechende Präfix (socks5:// oder http://) hinzu.

Auf Servern mit aktivierter IP-Autorisierung können Sie sich im Format ip:port ohne Benutzername direkt verbinden. CSV-Dateien enthalten in der ersten Zeile die Spaltennamen und beide Ports.

curl -H "Authorization: Bearer spx_your_api_key" \
  "https://socks5proxy.io/api/v1/proxies/download?format=url&protocol=socks5" -o proxies.txt

Codebeispiele: Python, Node.js, PHP

Das folgende Beispiel empfängt eine Liste und sendet eine Anfrage über den ersten Proxy. Für Python mit SOCKS5 ist das Paket requests[socks] erforderlich; mit socks5h wird auch die DNS-Auflösung über den Proxy durchgeführt.

import requests

API = "https://socks5proxy.io/api/v1"
H = {"Authorization": "Bearer spx_your_api_key"}

proxies = requests.get(f"{API}/proxies", headers=H, params={"country": "us"}).json()["proxies"]
p = proxies[0]
url = f"socks5h://{p['username']}:{p['password']}@{p['host']}:{p['socks5_port']}"
r = requests.get("https://api.ipify.org?format=json", proxies={"http": url, "https": url}, timeout=30)
print(r.json())

import { ProxyAgent, fetch } from "undici";

const API = "https://socks5proxy.io/api/v1";
const H = { Authorization: "Bearer spx_your_api_key" };

const { proxies } = await (await fetch(`${API}/proxies?country=us`, { headers: H })).json();
const p = proxies[0];
const agent = new ProxyAgent(`http://${p.username}:${p.password}@${p.host}:${p.http_port}`);
const r = await fetch("https://api.ipify.org?format=json", { dispatcher: agent });
console.log(await r.json());

<?php
$ch = curl_init("https://socks5proxy.io/api/v1/proxies/download?format=ip:port:user:pass&protocol=http");
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER => ["Authorization: Bearer spx_your_api_key"],
  CURLOPT_RETURNTRANSFER => true,
]);
$lines = explode("\n", trim(curl_exec($ch)));
[$host, $port, $user, $pass] = explode(":", $lines[0]);
echo "$host:$port\n";

Fehlercodes und Rate Limits

Fehler werden als JSON { "error": { "code", "message" } } mit HTTP-Statuscode zurückgegeben. Pro Key sind 300 Anfragen/Minute erlaubt (429 bei Überschreitung). Da sich Listen nur bei Kauf/Ablauf ändern, raten wir zum einmaligen Abruf und lokalen Caching.

API-Aufrufe sind kostenlos. Das Guthaben wird nur beim Kauf von Plänen im Dashboard belastet.