SuperNova Proxy SuperNova
Se connecter S'inscrire →

Documentation de l'API Développeur

Utilisez notre API pour simplifier votre vie ou à des fins de revente

Documentation de l'API Développeur

Votre service vous permet de travailler avec nous via une API. Cela peut être utile si votre logiciel prend en charge les API ou si vous souhaitez redistribuer nos proxies sous votre marque ou via votre boutique. Tout d'abord, connectez-vous à votre compte. En haut de cette page, vous trouverez un formulaire pour créer une clé API. Cette clé est utilisée pour toutes les requêtes à notre API. Vous n'êtes autorisé à avoir qu'une seule clé API. Vous pouvez actualiser votre clé API à tout moment ; les anciennes seront désactivées automatiquement.

Recommandations :

1. Mettez à jour les pays, états/régions et villes au moins 1 fois par minute ou avant la création/mise à jour des liens de proxy

2. Les formats de liens proxy évoluent très rarement. Contactez le support si vous avez besoin d'un format spécial.

3. Ne contournez pas les limites des sous-comptes ! Si vous vendez des liens proxy, définissez toujours des limites sous peine de perdre des fonds de votre solde !

4. Vous pouvez utiliser votre nom de domaine pour les connexions clients au lieu du nôtre : interrogez notre passerelle de connexion pour obtenir notre adresse IP actuelle et mettez à jour vos enregistrements DNS. Nous ne prenons en charge que les adresses IPv4 et rejetons les connexions IPv6. Contactez le support si besoin.

Informations générales

Vous devez ajouter votre clé API dans l'en-tête de la requête : 

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

Les erreurs auront un code HTTP, une description courte et toujours le flag 'success'=false :

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

Une limitation de débit est appliquée à tous les endpoints API pour votre sécurité. Évitez les requêtes trop fréquentes sous peine de recevoir une erreur 429. Si vous avez besoin de plus de requêtes, contactez le support. L'en-tête de réponse indique le nombre de requêtes restantes avant l'erreur 429 :

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

Solde du compte

Requête pour obtenir le solde actuel de votre compte :

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

Une réponse réussie à la requête contiendra :

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
}

Pays disponibles

Requête pour obtenir les pays disponibles. Notez que cette liste inclut tous les pays des proxies, tous types confondus. Correspond au paramètre 'Tous les types'. Vous ne pouvez pas filtrer les pays par type.

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

Une réponse réussie à la requête contiendra :

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

États/Régions et Pays disponibles

Requête pour obtenir les états/régions d'un pays sélectionné. Notez que cette liste inclut régions et villes pour tous les types de proxies (Mobile, Résidentiel, Mixte). Correspond au paramètre 'Tous les types'. Vous ne pouvez pas filtrer par type. Une erreur survient si le pays n'est pas spécifié. Vous obtiendrez toujours tous les états/régions du pays.

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

Vous pouvez filtrer les villes d'un état en précisant son ID :

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

Une réponse réussie à la requête contiendra :

{
    "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
}

Formats des liens proxy

Requête pour obtenir les formats de liens proxy disponibles (vous aurez besoin de l'ID de format pour générer des liens !)

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

Une réponse réussie à la requête contiendra :

{
    "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
}

Sous-comptes actifs

Un sous-compte peut être vu comme un utilisateur dans votre système. Les sous-comptes peuvent être actifs ou archivés, avec des limites de date, dépenses et trafic. Le sous-compte est l'entité principale pour le suivi des statistiques.

Évitez d'utiliser un même sous-compte pour plusieurs utilisateurs, car ils partagent le mot de passe et les limites !

Pour obtenir la liste des sous-comptes actifs, effectuez cette requête. Paramètres optionnels : p (page) et l (limite par page). Pagination activée par défaut. Maximum 300 éléments par requête.

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

Une réponse réussie à la requête contiendra :

{
    "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
}

Statuts possibles des sous-comptes :


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

Sous-comptes archivés

Vous pouvez archiver les sous-comptes inutilisés. Pour les lister, effectuez cette requête. Paramètres optionnels : p (page) et l (limite par page). Pagination activée par défaut. Maximum 300 éléments par requête.

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

Une réponse réussie à la requête contiendra :

{
    "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
}

Une réponse réussie à la requête contiendra :

Vous pouvez ajouter un sous-compte avec limites et mot de passe. Si non précisé, le mot de passe sera généré automatiquement.

Définissez toujours des limites si vous revendez nos proxies !

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"
  }'
Vous trouverez ci-dessous la description de chaque champ de requête :
{
  "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)
}'

Une réponse réussie à la requête contiendra :

{
  "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
}

Modifier un sous-compte (Liste ou Port)

Pour modifier un sous-compte, vous avez besoin de son identifiant Port ! La requête est similaire, mais ajoutez le champ 'port'.

Si le champ 'port' n'est pas précisé, un nouveau sous-compte sera créé !

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"
  }'
Vous trouverez ci-dessous la description de chaque champ de requête :
{
  "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)
}'

Une réponse réussie à la requête contiendra :

{
  "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
}

Démarrer, Arrêter, Archiver ou Restaurer

Vous pouvez modifier le statut d'un sous-compte, ce qui arrêtera/démarrera immédiatement son fonctionnement comme proxy.

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"
  }'
Vous trouverez ci-dessous la description de chaque champ de requête :
{
  "port": "YOUR_SUBACCOUNT_IDENTIFICATOR", // Identificator of your Subaccount. Mandatory field for edit subaccount.
  "command": "start" // Possible values of command: 'archive' 'restore' 'pause' 'start'
}'

Une réponse réussie à la requête contiendra :

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

Générer des liens de connexion proxy

Pour générer des liens, spécifiez : sous-compte, type de lien, quantité (jusqu'à 10 000), type de rotation, pays (obligatoire), état/région (optionnel) et ville (optionnel).

Notez bien l'URL de requête. L'identifiant de sous-compte ('port') est dans l'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
}'
Vous trouverez ci-dessous la description de chaque champ de requête :
{
  "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. 
}'

Une réponse réussie à la requête contiendra :

{
  "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
}