Diese Anleitung zeigt, wie du von Grund auf neue Proxys über die API kaufst — Verfügbarkeit prüfen, Preis berechnen, Bestellung aufgeben und die gekauften IPs abrufen.

Jede Anfrage verwendet deinen persönlichen API-Schlüssel aus deinem Konto-Dashboard (So erhältst du deinen API-Schlüssel). Ersetze in den folgenden Beispielen YOUR_API_KEY durch deinen eigenen Schlüssel. Um vom Kontoguthaben zu bezahlen, verwende paymentId = 1.

⚠️ Der Bestellschritt belastet dein Guthaben. Prüfe die Kosten immer zuerst im Berechnungsschritt.

Der Ablauf im Überblick

Prüfe dein Guthaben.
Sieh nach, was bestellt werden kann (Land, Zeitraum).
Wähle eine Zahlungsmethode (oder nutze dein Guthaben).
Berechne den Preis.
Gib die Bestellung auf.
Rufe die gekauften Proxys ab.

Schritt 1 — Guthaben prüfen

Stelle sicher, dass dein Guthaben für den Kauf ausreicht.

Endpunkt

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get

Antwort

{
  "status": "success",
  "data": { "summ": 10 },
  "errors": []
}

Schritt 2 — Nachsehen, was bestellt werden kann

Die Reference List liefert alles für eine Bestellung: Länder, Zeiträume, Ziele, Carrier und Rotationen (für Mobile). Kopiere die benötigten countryId und periodId.

Endpunkt

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/{type}

Pfadparameter

Name	Wert	Beschreibung
type	`ipv4`	Der Proxy-Typ (ipv4, ipv6, mobile, isp, mix, mix_isp).

Beispiel

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/ipv4

Antwort

{
  "status": "success",
  "data": {
    "items": [
      {
        "country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
        "period":  [ { "id": "1m", "name": "1 month" } ]
      }
    ]
  },
  "errors": []
}

Schritt 3 — Zahlungsmethode wählen

Liste die verfügbaren Zahlungssysteme auf und kopiere die gewünschte id als paymentId. Um vom Guthaben zu bezahlen, verwende einfach paymentId = 1.

Endpunkt

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list

Antwort

{
  "status": "success",
  "data": {
    "items": [
      { "id": "30", "name": "Visa / MasterCard" },
      { "id": "41", "name": "USDT (TRC-20)" },
      { "id": "29", "name": "PayPal" },
      { "id": "35", "name": "Binance" }
    ]
  },
  "errors": []
}

Schritt 4 — Preis berechnen

Berechne den Bestellpreis vor dem Kauf. Mengen- und Laufzeitrabatte werden wie auf der Website angewendet. Dieser Schritt bucht nichts ab.

Die Body-Felder hängen vom Proxy-Typ ab. Die gemeinsamen Felder stehen unten; für IPv6 zusätzlich protocol, für Mobile operatorId + rotationId, für Residential tarifId — alles aus der Reference List.

Endpunkt

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

Anfrage-Body

Name	Typ	Beschreibung
countryId	Number	ID des Landes aus der Reference List (Schritt 2).
periodId	String	ID des Mietzeitraums aus der Reference List.
quantity	Number	Die Anzahl der zu bestellenden Proxys.
paymentId	Number	Zahlungssystem-ID. `1` = Guthaben, `43` = hinterlegte Karte.
coupon (optional)	String	Ein Gutscheincode, falls vorhanden.
authorization (optional)	String	Autorisierungsmethode. Leer lassen für Login:Passwort.
customTargetName (optional)	String	Ein eigener Ziel-/Target-Name, falls nötig.

Beispiel

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

Antwort — shows the total, your balance, the discount and the per-proxy price:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 2000,
    "total": 9,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.45,
    "price": 1.8
  },
  "errors": []
}

Schritt 5 — Bestellung aufgeben (belastet dein Guthaben)

Wenn der berechnete Preis passt, gib die Bestellung auf. Dieser Schritt belastet dein Guthaben. Verwende dieselben Parameter wie in Schritt 4. Kopiere die orderId aus der Antwort.

Endpunkt

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

Anfrage-Body

Name	Typ	Beschreibung
countryId	Number	ID des Landes aus der Reference List (Schritt 2).
periodId	String	ID des Mietzeitraums aus der Reference List.
quantity	Number	Die Anzahl der zu bestellenden Proxys.
paymentId	Number	Zahlungssystem-ID. `1` = Guthaben, `43` = hinterlegte Karte.
coupon (optional)	String	Ein Gutscheincode, falls vorhanden.
authorization (optional)	String	Autorisierungsmethode. Leer lassen für Login:Passwort.
generateAuth (optional)	String	Y/N — eigene Autorisierung erstellen (Standard N).

Beispiel

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

Antwort — returns the new order ID and your updated balance:

{
  "status": "success",
  "data": {
    "orderId": 2426273,
    "total": 16.2,
    "listBaseOrderNumbers": [ "3388485_57471911" ],
    "balance": 1776.88
  },
  "errors": []
}

Schritt 6 — Gekaufte Proxys abrufen

Rufe die gekauften Proxys ab. Filtere nach der orderId aus dem vorigen Schritt, um genau das Gekaufte zu sehen.

Endpunkt

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}

Antwort

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "0678564",
        "order_id": "123456",
        "ip": "31.6.33.97",
        "protocol": "HTTP",
        "port_http": 12345,
        "port_socks": 12345,
        "login": "ruht5734hg",
        "password": "gou5h437g",
        "country": "Belgium",
        "country_alpha3": "BEL",
        "status_type": "ACTIVE",
        "date_start": "23.06.2024",
        "date_end": "23.07.2024"
      }
    ]
  },
  "errors": []
}