Proxy-seller

Aktionen mit Proxys

Aktualisiert:

Verwalten Sie IP-Adressen im Rahmen Ihrer Proxy-AuftrĂ€ge – listen Sie sie auf, wechseln Sie sie ab, verlĂ€ngern Sie sie oder versehen Sie sie mit Anmerkungen.

Gemeinsamer Parameter. Jeder Endpunkt auf dieser Seite arbeitet mit einer bestimmten Reihenfolge. Übergeben Sie „orderNumber“ – diese entnehmen Sie GET /proxy/list.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list
Gibt aktive Proxys nach Typ gruppiert zurĂŒck.
GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list/{type}
Gibt aktive Proxys eines Typs zurĂŒck. UnterstĂŒtzt dieselben Abfrageparameter wie /proxy/list

Pfadparameter

Name

Wert

Erforderlich

Beschreibung

Typ

ipv4, ipv6, mobile, isp, mix, mix_isp, oder resident

Ja

Legt fest, welche Art von Proxys in die heruntergeladene Liste aufgenommen werden sollen.


Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-SchlĂŒssel (So erhalten Sie)

Abfrageparameter

Name

Typ

Erforderlich

Beschreibung

Aktuell

String

Nein

Ygibt Proxies aus dem zuletzt aktiven Auftrag zurĂŒck, wenn orderId wird nicht bereitgestellt.

orderId

String

Nein

Gib einen Proxy fĂŒr eine bestimmte `orderId` oder `OrderPart.number` zurĂŒck

Land

String

Nein

Alpha3-LĂ€ndername (FRA oder DEU re
)

Ende

String

Nein

Y gibt nur zurĂŒck ENDED Proxys, die noch dateEnd in Zukunft. Andernfalls sind geschlossene Proxys ausgeschlossen.

Beispiel

So rufen Sie Proxys aller Art ab:

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list

So rufen Sie Proxys eines bestimmten Typs (z. B. IPv4) ab:

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list/ipv4

Antwort

Alle Arten von Proxys

{
  "status": "success",
  "data": {
    "ipv4": [],
    "ipv6": [],
    "mobile": [],
    "isp": [],
    "mix": [],
    "mix_isp": [],
    "resident": []
  },
  "errors": []
}

Eine Art von Proxy

{
    "status": "success",
    "data": {
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ]
    },
    "errors": []
}

Falsche Art von Proxy

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list/{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

Bitte beachten Sie: Wenn kein Proxy-Typ angegeben wird, werden alle verfĂŒgbaren Typen fĂŒr Ihr Profil zurĂŒckgegeben.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/download/{type}
IPs exportieren
Über diesen API-Endpunkt können Sie die Liste Ihrer Proxys herunterladen.

Pfadparameter:

Name

Wert

Erforderlich

Beschreibung

Typ

ipv4, ipv6, mobile, isp, mix, mix_isp, oder resident

Ja

Legt fest, welche Art von Proxys in die heruntergeladene Liste aufgenommen werden sollen.

Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-SchlĂŒssel (So erhalten Sie)

Optionale Parameter

Name

Wert

Beschreibung

ext

txt

csv

Gibt das Format an, in dem die Proxy-Liste heruntergeladen wird.

%login%:%password%@%ip%:%port%

Benutzerdefiniertes Format

proto

https

socks5

Gibt das von Ihnen bevorzugte Proxy-Port-Format fĂŒr die Proxys an.

listId

Ganzzahl

Proxy-Listen-ID (nur fĂŒr Resident; falls nicht festgelegt, wird die IP-Adresse aus allen Tabellen zurĂŒckgegeben)

package_key

String

Proxy-Liste „package_key“ (nur fĂŒr Subresident)

Land

String

Alpha3-LĂ€ndername (FRA oder USA oder 
)

Ende

String

Y - Liste der Endungs-Proxies

Beispiel

So rufen Sie Proxys eines bestimmten Typs (z. B. IPv4) ab:

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/download/ipv4?ext=txt&proto=https

Antwort

login:[email protected]:80;

login:[email protected]:81;

Fehler: Falscher Proxy-Typ

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

Bearbeiten

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/replace
IP-Adressen ersetzen
Wechseln Sie eine IP-Adresse, ohne den Platz in der Reihenfolge zu verlieren. Wird auf das monatliche Austauschkontingent angerechnet.

Pfadparameter

Name

Wert

Erforderlich

Beschreibung

Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-SchlĂŒssel (So erhalten Sie)

Anfragetext

Name

Typ

Beschreibung

ids

Nummer

Eine einzelne ID oder ein Array von IDs in „[ ]“, durch Kommas getrennt

Kommentar

String

Optionaler Kommentar, der dem Auftrag beigefĂŒgt werden kann

Typ

String

Art der Ersetzung

Beispiel

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/replace
{
    "ids": ["10"],
    "type": "CUSTOM",
    "comment": "Test replace IP"
}

Antwort

{
    "status": "success",
    "data": {
        "ok": {
            "ips": [
                "11.55.11.0"
            ],
            "msg": "Replacement request submitted"
        }
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 503,
            "message": "Error api key",
            "customData": null
        },
        {
            "code": 503,
            "message": "IP not allowed",
            "customData": null
        },
        {
            "code": 503,
            "message": "Request limit reached",
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set coorect type: NOT_WORK / INCORRECT_LOCATION / CANT_CHANGE_NETWORK / LOW_SPEED / CUSTOM",
            "customData": null
        }
    ]
}

Ersetzungsarten: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM

POST https://proxy-seller.com/personal/api/v2/{apiKey}/prolong/calc/{type}
IPs verlÀngern
VerlĂ€ngerung der GĂŒltigkeitsdauer fĂŒr ausgewĂ€hlte IP-Adressen. Abrechnung pro IP-Tag.

Dieses Dokument enthĂ€lt eine detaillierte Anleitung zur Einrichtung der automatischen VerlĂ€ngerung fĂŒr Ihre IP-Adressen verschiedener Typen. Bitte beachten Sie, dass IP-Adressen rechtzeitig verlĂ€ngert werden mĂŒssen, um die gleichen Adressen beizubehalten.

Erweiterung berechnen

Über diesen Endpunkt können Sie die Kosten berechnen. Mengen- und Laufzeitrabatte entsprechen denen, die unser Service anbietet.

Pfadparameter

Name

Wert

Erforderlich

Beschreibung

Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-SchlĂŒssel (So erhalten Sie)

Typ

ipv4

ipv6

mobile

isp

mix

mix_isp

Ja

Der Proxy-Typ, den Sie erweitern möchten

Anfragetext

Name

Typ

Beschreibung

ids

Nummer

Eine einzelne ID oder ein Array von IDs in „[ ]“, durch Kommas getrennt (so geht’s)

Gutschein

String

Der Kommentar, den Sie hinzufĂŒgen möchten

periodId

String

ID des Zeitraums, den Sie in der Anfrage /reference/list/{type} ausgewÀhlt haben

Beispiel (z. B. IPv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/calc/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

Antwort

{
    "status": "success",
    "data": {
        "warning": "",
        "balance": 498648.72,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login ",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/prolong/make/{type}
IPs verlÀngern
In diesem Abschnitt erfahren Sie, wie Sie eine VerlÀngerungsbestellung erstellen.

Erstellen Sie einen VerlÀngerungsauftrag

Erstellt einen Erweiterungsauftrag.

Pfadparameter

Name

Wert

Erforderlich

Beschreibung

Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-SchlĂŒssel (So erhalten Sie)

Typ

ipv4

ipv6

mobile

isp

mix

mix_isp

Ja

Der Proxy-Typ, den Sie erweitern möchten

Anfragetext

Name

Typ

Beschreibung

ids

Nummer

Eine einzelne ID oder ein Array von IDs in „[ ]“, durch Kommas getrennt (So erhalten Sie sie)

Gutschein

String

Promo-Code.

periodId

String

ID des Zeitraums, den Sie in der Anfrage /reference/list/{type} ausgewÀhlt haben

paymentId

String

IDs des Zahlungssystems "69e799e7497b2c153b33faca„ – Balance, „69e799e8497b2c153b33faed„ – Karte, die du in deine Sammlung aufgenommen hast“

Beispiel (z. B. IPv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/make/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

Antwort

{
    "status": "success",
    "data": {
        "orderId": "69fa4b795a1f522c7a53d589",
        "total": 3.49,
        "listBaseOrderNumbers": [
            "TEST_1778011001948-uc_e_UUf2Z3RtGH"
        ],
        "balance": 1.00
    },
    "errors": []
}
{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "base_order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "ip": "11.55.11.0",
                "port_http": null,
                "port_socks": null,
                "login": "x2alltop0qRU6",
                "password": "gwBwtL9LMM",
                "authIp": "",
                "country": "Germany",
                "date_start": "05.05.2026 19:56:42",
                "date_end": "10.08.2026 23:59:59",
                "comment": "",
                "status": "Active",
                "rotation": null,
                "link_reboot": "#",
                "can_prolong": true
            }
        ],
        "orders": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/comment/set
Kommentare hinzufĂŒgen
FĂŒgen Sie eine Freitext-Notiz (max. 256 Zeichen) hinzu, um die Identifizierung einer IP in der BenutzeroberflĂ€che oder in Exportdateien zu erleichtern.

Pfadparameter

Name

Wert

Erforderlich

Beschreibung

Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-SchlĂŒssel (So erhalten Sie)

Anfragetext

Name

Typ

Beschreibung

ids

Nummer

Eine einzelne ID oder ein Array von IDs in „[ ]“, durch Kommas getrennt (so geht’s)

Kommentar

String

Der Kommentar, den Sie hinzufĂŒgen möchten

Beispiel

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/comment/set
{
    "ids": ["10"],
    "comment": "My server"
}

Antwort

{
    "status": "success",
    "data": {
        "updated": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

Gilt fĂŒr alle Proxy-Endpunkte

  1. Basis-URL

    https://proxy-seller.com/personal/api/v2/{YourApiKey}/

  2. Authentifizierung

    API-SchlĂŒssel im URL-Pfad.

  3. Fehlermodell

    GeschĂ€ftliche Fehler geben den HTTP-Status 200 zurĂŒck mit errors[] ausgefĂŒllt.

Nachdem Sie Ihre IPs verwaltet haben

Authorizationissue per-order credentialsOpenOrder actionsbuy more proxies when you need additional IPsOpenBalancecheck funds before bulk prolongationOpen

On this page

Pfadparameter
Abfrageparameter
Beispiel
Antwort
Pfadparameter:
Optionale Parameter
Beispiel
Antwort
Bearbeiten
Pfadparameter
Anfragetext
Beispiel
Antwort
Erweiterung berechnen
Pfadparameter
Anfragetext
Beispiel (z. B. IPv4)
Antwort
Erstellen Sie einen VerlÀngerungsauftrag
Pfadparameter
Anfragetext
Beispiel (z. B. IPv4)
Antwort
Pfadparameter
Beispiel
Antwort
Gilt fĂŒr alle Proxy-Endpunkte
1
Basis-URL
2
Authentifizierung
3
Fehlermodell
Nachdem Sie Ihre IPs verwaltet haben
Aktionen mit Proxys | Proxy-seller