SuperNova Proxy SuperNova
Anmelden Registrieren →

Dokumentation der Entwickler-API

Nutzen Sie unsere API, um Ihr Leben zu vereinfachen oder für Weiterverkaufszwecke

Dokumentation der Entwickler-API

Ihr Dienst ermöglicht die Zusammenarbeit mit uns über die API. Dies ist nützlich, wenn Ihre Software API unterstützt oder wenn Sie unsere Proxies unter Ihrer Marke oder über Ihren Shop weitervertreiben möchten. Melden Sie sich zunächst in Ihrem Konto an. Oben auf dieser Seite finden Sie ein Formular zum Erstellen eines API-Schlüssels. Der API-Schlüssel wird für alle Anfragen an unsere API verwendet. Sie dürfen nur einen API-Schlüssel besitzen. Sie können Ihren API-Schlüssel jederzeit aktualisieren, alte Schlüssel werden automatisch deaktiviert.

Empfehlungen:

1. Aktualisieren Sie Länder, Bundesländer/Regionen und Städte mindestens 1 Mal pro Minute oder vor der Erstellung/Aktualisierung von Proxy-Links

2. Link-Formate werden selten aktualisiert. Kontaktieren Sie den Support, wenn Sie ein spezielles Proxy-Link-Format benötigen

3. Ignorieren Sie die Unterkontenlimits nicht! Wenn Sie Proxy-Links verkaufen, setzen Sie immer Limits, sonst könnten Sie Guthaben von Ihrem Konto verlieren!

4. Sie können Ihre eigene Domain für Client-Verbindungen verwenden: Pingen Sie unser Verbindungs-Gateway an, erhalten Sie unsere aktuelle IP-Adresse und aktualisieren Sie Ihre DNS-Einträge, um unsere IPv4-Adresse anzupinnen. IPv6-Verbindungen werden nicht unterstützt. Kontaktieren Sie den Support bei Fragen.

Allgemeine Informationen

Fügen Sie Ihren API-Schlüssel zum Anfrage-Header hinzu: 

Content-Type: application/json
Authorization: ApiKey 00000000-0000-0000-0000-000000000000

Fehler enthalten HTTP-Code, Kurzbeschreibung und immer das Flag 'success'=false:

{
  "data": {
    "general": "API key not recognized or user is blocked"
  },
  "success": false
}

Aus Sicherheitsgründen gelten Rate-Limits für alle API-Endpunkte. Vermeiden Sie zu häufige Anfragen (sonst 429-Fehler). Bei Bedarf an mehr Anfragen kontaktieren Sie unseren Support. In Response-Headern sehen Sie verbleibende Anfragen bis zum 429-Fehler:

< X-Ratelimit-Limit: 5
< X-Ratelimit-Remaining: 4
< X-Ratelimit-Reset: 15

Kontostand

Anfrage zum Abrufen Ihres aktuellen Kontostands:

curl -X GET https://supernovanet.org/api/v1/balance -H "Authorization: ApiKey 00000000-0000-0000-0000-000000000000" ### Get Balance
GET https://supernovanet.org/api/v1/balance
Authorization: ApiKey 00000000-0000-0000-0000-000000000000

Erfolgreiche Antwort auf Anfrage lautet:

HTTP/1.1 200 OK
Date: Thu, 01 Apr 2025 00:00:00 GMT
Content-Type: application/json
Content-Length: 73
X-Ratelimit-Limit: 5
X-Ratelimit-Remaining: 4
X-Ratelimit-Reset: 15
Connection: close

{
  "data": {
    "balance_string": "$14.97",
    "balance_float": 14.97
  },
  "success": true
}

Verfügbare Länder

Anfrage zum Abrufen verfügbarer Länder. Die Liste enthält alle Länder aller Proxy-Typen. Filterung nach Proxy-Typen ist nicht möglich.

curl -X GET https://supernovanet.org/api/v1/inventory/countries -H "Authorization: ApiKey 00000000-0000-0000-0000-000000000000"

Erfolgreiche Antwort auf Anfrage lautet:

{
    "data": [{
        "name": "France",
        "iso": "FR"
    }, 
    ... // More countries in the list
    {
        "name": "Latvia",
        "iso": "LV"
    }],
    "success": true
}

Verfügbare Bundesländer/Regionen und Länder

Anfrage zum Abrufen verfügbarer Bundesländer/Regionen eines Landes. Die Liste enthält Regionen/Städte aller Proxy-Typen (Mobile, Residential, Mixed). Filterung nach Proxy-Typen ist nicht möglich. Fehler bei fehlender Länderangabe. Es werden immer alle Bundesländer/Regionen des gewählten Landes zurückgegeben.

curl -X GET "https://supernovanet.org/api/v1/inventory/targeting?country=US" -H "Authorization: ApiKey 00000000-0000-0000-0000-000000000000"

Sie können Städte in einem Bundesland/Region filtern, indem Sie die Bundesland/Region-ID angeben:

curl -X GET "https://supernovanet.org/api/v1/inventory/targeting?country=US&state=4361885" -H "Authorization: ApiKey 00000000-0000-0000-0000-000000000000"

Erfolgreiche Antwort auf Anfrage lautet:

{
    "data": {
        "states": [{
                "name": "Maryland",
                "id": 4361885
            },
            ... // More states
            {
                "name": "Illinois",
                "id": 4896861
            }
        ],
        "cities": [{
                "name": "Kissimmee",
                "id": 4160983
            },
            ... // More cities
            {
                "name": "Ellsworth",
                "id": 4963692
            }
        ]
    },
    "success": true
}

Proxy-Link-Formate

Anfrage zum Abrufen verfügbarer Proxy-Link-Formate (Sie benötigen die Format-ID, um später Links zu generieren!)

curl -X GET https://supernovanet.org/api/v1/formats -H "Authorization: ApiKey 00000000-0000-0000-0000-000000000000"

Erfolgreiche Antwort auf Anfrage lautet:

{
    "data": [{
        "id": 1,
        "name": "login:pass@host:port",
        "description": "No scheme: login:pass@host:port",
        "format": "{login}:{password}@{host}:{port}"
    }, 
    ... // More formats in the list
    {
        "id": 2,
        "name": "login:pass@ip:port",
        "description": "No scheme: login:pass@ip:port",
        "format": "{login}:{password}@{ip}:{port}"
    }],
    "success": true
}

Aktive Unterkonten

Unterkonten können als Benutzer in Ihrem System betrachtet werden. Sie können aktiv oder archiviert sein und Limits für Datum, Ausgaben und Traffic haben. Unterkonten sind die Hauptentität zur Statusverfolgung.

Vermeiden Sie, ein Unterkonto für mehrere Benutzer zu nutzen, da sie das Verbindungspasswort und alle Limits teilen!

Anfrage zur Liste aktiver Unterkonten. Optionale Parameter: p (Seite) und l (Limit pro Seite). Paginierung ist standardmäßig aktiviert. Maximale Elemente pro Anfrage (l): 300.

curl -X GET "https://supernovanet.org/api/v1/subaccounts/active?p=1&l=30" -H "Authorization: ApiKey 00000000-0000-0000-0000-000000000000"

Erfolgreiche Antwort auf Anfrage lautet:

{
    "data": {
        "limit": 30,
        "page": 1,
        "total_rows": 1,
        "total_pages": 1,
        "rows": [{
            "port": "YOUR_SUBACCOUNT_IDENTIFICATOR", // Main identificator of your Subaccount
            "name": "My List №1",
            "total_traffic": 0, // In Bytes
            "total_spend": 0, // In Dollars
            "status": 1, // See below 
            "amount_limit": 123, // In Dollars
            "traffic_limit": 1, // In Gigabytes
            "date_limit": "2025-04-20T00:00:00+00:00",
            "last_bytes_at": null,
            "created_at": "2025-04-16T17:35:13.313+00:00"
        }]
    },
    "success": true
}

Status von Unterkonten:


WORKING = 0
PAUSED = 1
PAUSED DUE TO SUBACCOUNT LIMITS = 2
PAUSED DUE TO NO FUNDS = 3

Archivierte Unterkonten

Unterkonten können archiviert werden. Anfrage zur Liste archivierter Unterkonten. Optionale Parameter: p (Seite) und l (Limit pro Seite). Paginierung ist standardmäßig aktiviert. Maximale Elemente pro Anfrage (l): 300.

curl -X GET "https://supernovanet.org/api/v1/subaccounts/archived?p=1&l=30" -H "Authorization: ApiKey 00000000-0000-0000-0000-000000000000"

Erfolgreiche Antwort auf Anfrage lautet:

{
    "data": {
        "limit": 30,
        "page": 1,
        "total_rows": 1,
        "total_pages": 1,
        "rows": [{
            "port": "YOUR_SUBACCOUNT_IDENTIFICATOR", // Main identificator of your Subaccount
            "name": "My List №1",
            "total_traffic": 0, 
            "total_spend": 0, 
            "status": 1, // Status automatically set to Paused when you archive your subaccount!
            "amount_limit": 123, 
            "traffic_limit": 1,
            "date_limit": "2025-04-20T00:00:00+00:00",
            "last_bytes_at": null,
            "created_at": "2025-04-10T17:35:13.313+00:00",
            "archived_at":"2025-04-16T18:20:44.024+00:00" // Pay attention to new field in archived
        }]
    },
    "success": true
}

Erfolgreiche Antwort auf Anfrage lautet:

Unterkonto mit Limits und Passwort hinzufügen. Bei keiner Passwortangabe wird es automatisch generiert.

Setzen Sie immer Limits, wenn Sie Proxies weiterverkaufen!

curl -X POST https://supernovanet.org/api/v1/subaccounts/add \
  -H "Content-Type: application/json" \
  -H "Authorization: ApiKey 00000000-0000-0000-0000-000000000000" \
  -d '{
    "name": "Test Subaccount",
    "password": "testpassword123",
    "amount_limit": 100.0,
    "traffic_limit": 1024.0,
    "date_limit": "2025-12-31"
  }'
Beschreibung der einzelnen Anfragefelder finden Sie unten:
{
  "name": "Test Subaccount", // Name of your Subaccount (for your convenience)
  "password": "testpassword123", // Password. Leave it blank and we will generate it by our own
  "amount_limit": 100.0, // Amount in US dollars after this subaccount will be stopped
  "traffic_limit": 1024.0, // Amount in Gigabytes after this subaccount will be stopped
  "date_limit": "2025-12-31" // Date after this subaccount will be stopped (last working date)
}'

Erfolgreiche Antwort auf Anfrage lautet:

{
  "data": {
    "port": "YOUR_SUBACCOUNT_IDENTIFICATOR", // This identificator will be required to edit port later!
    "password": "testpassword123",
    "name": "Test Subaccount",
    "total_traffic": 0,
    "total_spend": 0,
    "status": 0,
    "amount_limit": 100,
    "traffic_limit": 1024,
    "date_limit": "2025-12-31T00:00:00+00:00",
    "last_bytes_at": null,
    "created_at": "2025-04-01T12:00:00.000+00:00"
  },
  "success": true
}

Unterkonto bearbeiten (Liste oder Port)

Zum Bearbeiten benötigen Sie die Port-ID! Anfrage ist identisch, aber mit zusätzlichem 'port'-Feld.

Ohne 'port'-Feld wird ein neues Unterkonto erstellt!

curl -X POST https://supernovanet.org/api/v1/subaccounts/edit \
  -H "Content-Type: application/json" \
  -H "Authorization: ApiKey 00000000-0000-0000-0000-000000000000" \
  -d '{
    "port": "YOUR_SUBACCOUNT_IDENTIFICATOR",
    "name": "Test Subaccount",
    "password": "testpassword123",
    "amount_limit": 100.0,
    "traffic_limit": 1024.0,
    "date_limit": "2025-12-31"
  }'
Beschreibung der einzelnen Anfragefelder finden Sie unten:
{
  "port": "YOUR_SUBACCOUNT_IDENTIFICATOR", // Identificator of your Subaccount. Mandatory field for edit subaccount.
  "name": "Test Subaccount", // Name of your Subaccount (for your convenience)
  "password": "testpassword123", // Password. Leave it blank and we will generate it by our own
  "amount_limit": 100.0, // Amount in US dollars after this subaccount will be stopped
  "traffic_limit": 1024.0, // Amount in Gigabytes after this subaccount will be stopped
  "date_limit": "2025-12-31" // Date after this subaccount will be stopped (last working date)
}'

Erfolgreiche Antwort auf Anfrage lautet:

{
  "data": {
    "port": "YOUR_SUBACCOUNT_IDENTIFICATOR", // This identificator will be required to edit port later!
    "password": "testpassword123",
    "name": "Test Subaccount",
    "total_traffic": 0,
    "total_spend": 0,
    "status": 0,
    "amount_limit": 100,
    "traffic_limit": 1024,
    "date_limit": "2025-12-31T00:00:00+00:00",
    "last_bytes_at": null,
    "created_at": "2025-04-01T12:00:00.000+00:00"
  },
  "success": true
}

Start, Stop, Archivieren und Wiederherstellen

Verwalten Sie den Status von Unterkonten. Änderungen wirken sich sofort auf die Proxy-Funktionalität aus.

curl -X POST https://supernovanet.org/api/v1/subaccounts/command \
  -H "Content-Type: application/json" \
  -H "Authorization: ApiKey 00000000-0000-0000-0000-000000000000" \
  -d '{
    "port": "YOUR_SUBACCOUNT_IDENTIFICATOR",
    "command": "start"
  }'
Beschreibung der einzelnen Anfragefelder finden Sie unten:
{
  "port": "YOUR_SUBACCOUNT_IDENTIFICATOR", // Identificator of your Subaccount. Mandatory field for edit subaccount.
  "command": "start" // Possible values of command: 'archive' 'restore' 'pause' 'start'
}'

Erfolgreiche Antwort auf Anfrage lautet:

{
  "data": "ok",
  "success": true
}

Proxy-Verbindungslinks generieren

Zum Generieren von Proxy-Links müssen Sie Unterkonto, Link-Typ, Menge (bis zu 10.000), Rotationsart, Land (Pflicht), Bundesland/Region (optional) und Stadt (optional) angeben.

Achtung: Die Unterkonto-ID ('port'-Wert) ist Teil der Anfrage-URL!

curl -X POST https://supernovanet.org/api/v1/subaccounts/YOUR_SUBACCOUNT_IDENTIFICATOR/generate-links \
  -H "Content-Type: application/json" \
  -H "Authorization: ApiKey 00000000-0000-0000-0000-000000000000" \
  -d '{
    "link_type": 7,
    "mob": true,
    "res": true,
    "mix": true,
    "country": "US",
    "city": 123,
    "state": 45,
    "session": "rotate",
    "quantity": 1000
}'
Beschreibung der einzelnen Anfragefelder finden Sie unten:
{
  "link_type": 7, // Mandatory. This ID is from Proxy Link Formats
  "mob": true, // Mandatory. If you need Mobile proxies. Please pay attention that one of mob, res or mix fields must be true!
  "res": true, // Mandatory. If you need Residential proxies. Please pay attention that one of mob, res or mix fields must be true!
  "mix": true, // Mandatory. If you need Mixed proxies. Please pay attention that one of mob, res or mix fields must be true!
  "country": "US", // Mandatory! Country from list of available ones
  "city": 123,  // Optional: city id from Available States/Regions and Countries. Ignored if no that City available.
  "state": 45, // Optional: city id from Available States/Regions and Countries. Ignored if no that State available.
  "session": "rotate", // Mandatory. Possible values: "rotate", "keep"
  "quantity": 1000 // Optional. Links quantity. By default is one. Up to 10000, but specify reasonable amount. 
}'

Erfolgreiche Antwort auf Anfrage lautet:

{
  "data": [
    "http://YOUR_SUBACCOUNT_IDENTIFICATOR-iso-us-t-mrv-st-r-s-1cdvecqqnu:[email protected]:9090",
    "http://YOUR_SUBACCOUNT_IDENTIFICATOR-iso-us-t-mrv-st-r-s-xboz8dc60t:[email protected]:9090"
  ],
  "success": true
}