SuperNova Proxy SuperNova
Iniciar sesión Registrarse →

Documentación de la API para desarrolladores

Utiliza nuestra API para facilitar tu trabajo o para fines de reventa

Documentación de la API para desarrolladores

Tu servicio te permite trabajar con nosotros mediante API. Esto puede ser útil si tu software soporta API o si deseas redistribuir nuestros proxies bajo tu marca o a través de tu tienda. Primero, inicia sesión en tu cuenta y en la parte superior de esta página encontrarás un formulario para crear una clave API. La clave API se utiliza para todas las solicitudes a nuestra API. Solo puedes tener una clave API. Puedes actualizar tu clave API en cualquier momento, las anteriores se desactivarán automáticamente.

Recomendaciones:

1. Actualiza países, estados/regiones y ciudades al menos 1 vez por minuto o antes de crear o actualizar enlaces de proxy

2. Los formatos de enlace casi no se actualizan. Contacta al soporte si necesitas un formato especial de enlace proxy

3. ¡No ignores los límites de subcuentas! Si vendes enlaces proxy, siempre establece límites o podrías perder fondos de tu saldo

4. Puedes usar tu propio dominio para conexiones de clientes: haz ping a nuestro dominio de gateway, obtén nuestra IP actual y actualiza tus registros DNS. Solo soportamos IPv4 y bloqueamos IPv6. Contacta al soporte si necesitas ayuda.

Información general

Debes agregar tu clave API al encabezado de la solicitud: 

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

Los errores incluirán código HTTP, descripción breve y siempre el flag 'success'=false:

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

Se aplica límite de solicitudes por seguridad. No hagas solicitudes muy frecuentes o recibirás error 429. En los encabezados de respuesta verás las solicitudes restantes antes del error 429:

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

Saldo de cuenta

Solicitud para obtener tu saldo actual:

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

La respuesta exitosa a una solicitud será:

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
}

Países disponibles

Solicitud para obtener países disponibles. La lista incluye todos los países de todos los proxies sin filtrar por tipo.

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

La respuesta exitosa a una solicitud será:

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

Estados/Regiones y países disponibles

Solicitud para obtener estados/regiones de un país. Debes especificar el país. No se puede filtrar por tipo de proxy.

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

Puedes filtrar ciudades en un estado especificando su ID:

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

La respuesta exitosa a una solicitud será:

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

Formatos de enlaces proxy

Solicitud para obtener formatos de enlaces proxy (necesitarás el ID para generarlos después)

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

La respuesta exitosa a una solicitud será:

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

Subcuentas activas

Una subcuenta representa un usuario en tu sistema. Pueden tener límites de fecha, gasto y tráfico.

¡Evita usar una misma subcuenta para múltiples usuarios, ya que comparten contraseña y límites!

Para listar subcuentas activas, usa parámetros opcionales p (página) y l (límite). Máximo 300 elementos por solicitud.

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

La respuesta exitosa a una solicitud será:

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

Estados de las subcuentas:


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

Subcuentas archivadas

Solicitud para listar subcuentas archivadas. Parámetros opcionales p y l (máximo 300 elementos).

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

La respuesta exitosa a una solicitud será:

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

La respuesta exitosa a una solicitud será:

Puedes agregar subcuentas con límites y contraseña. Si no especificas contraseña, se generará automáticamente

¡Siempre establece límites si revendes 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"
  }'
A continuación encontrarás la descripción de cada campo de solicitud:
{
  "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)
}'

La respuesta exitosa a una solicitud será:

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

Editar subcuenta (Lista o Puerto)

Para editar, necesitas el identificador de puerto. Mismo request pero agregando campo 'port'

¡Si no especificas 'port' se creará una nueva subcuenta!

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"
  }'
A continuación encontrarás la descripción de cada campo de solicitud:
{
  "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)
}'

La respuesta exitosa a una solicitud será:

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

Iniciar, Detener, Archivar y Restaurar

Gestiona el estado de tu subcuenta para activar/desactivar su funcionamiento.

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"
  }'
A continuación encontrarás la descripción de cada campo de solicitud:
{
  "port": "YOUR_SUBACCOUNT_IDENTIFICATOR", // Identificator of your Subaccount. Mandatory field for edit subaccount.
  "command": "start" // Possible values of command: 'archive' 'restore' 'pause' 'start'
}'

La respuesta exitosa a una solicitud será:

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

Generar enlaces de conexión proxy

Para generar enlaces, especifica: subcuenta, tipo de enlace, cantidad (hasta 10k), tipo de rotación, país (obligatorio), estado/ciudad (opcionales)

¡El identificador de subcuenta ('port') debe estar en la 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
}'
A continuación encontrarás la descripción de cada campo de solicitud:
{
  "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. 
}'

La respuesta exitosa a una solicitud será:

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