SuperNova Proxy SuperNova
Entrar Cadastrar →

Documentação da API do Desenvolvedor

Use nossa API para facilitar sua vida ou para fins de revenda

Documentação da API do Desenvolvedor

Seu serviço permite trabalhar conosco via API. Pode ser útil quando seu software suporta API ou se deseja redistribuir nossos proxies sob sua marca ou através de sua loja. Primeiro, faça login em sua conta e no topo desta página você encontrará um formulário para criar uma chave API. A chave API é usada para todas as requisições à nossa API. Você pode ter apenas uma chave API. Você pode atualizar sua chave API a qualquer momento - as antigas serão desativadas automaticamente.

Recomendações:

1. Atualize países, estados/regiões e cidades pelo menos 1 vez por minuto ou antes da criação/atualização de links de proxy

2. Os formatos de link são atualizados raramente. Contate o suporte se precisar de um formato especial de link

3. Não ignore os limites das subcontas! Se vender links de proxy, defina sempre limites ou poderá perder fundos de seu saldo!

4. Você pode usar seu próprio domínio para conexões de clientes: faça ping em nosso gateway de conexões para obter nosso IP atual e atualize seus registros DNS. Suportamos apenas IPv4 e bloqueamos conexões IPv6. Contate o suporte se precisar de ajuda.

Informações Gerais

Adicione sua chave API ao cabeçalho da requisição: 

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

Erros terão código HTTP, descrição curta e sempre o flag 'success'=false:

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

Limitação de taxa aplicada a todos os endpoints por segurança. Não faça requisições muito frequentes para evitar o erro 429. Caso precise de mais requisições, contate nosso suporte. No cabeçalho da resposta você verá as requisições restantes antes do erro 429:

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

Saldo da Conta

Requisição para obter seu saldo atual:

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

Resposta bem-sucedida à requisição:

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 Disponíveis

Requisição para obter países disponíveis. Atenção: lista inclui países de todos os proxies, independente do tipo. Equivale a selecionar todos os tipos. Não é possível filtrar países por tipo.

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

Resposta bem-sucedida à requisição:

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

Estados/Regiões e Países Disponíveis

Requisição para obter estados/regiões de um país selecionado. Atenção: lista inclui regiões e cidades de todos os tipos de proxies (Móvel, Residencial, Misto). Não é possível filtrar por tipo. Erro ocorrerá se o país não for especificado. Sempre retorna todos estados/regiões do país selecionado.

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

Você pode filtrar cidades em um estado especificando o ID do estado:

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

Resposta bem-sucedida à requisição:

{
    "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 Link de Proxy

Requisição para obter formatos de link de proxy (você precisará do ID do formato para gerar links depois!)

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

Resposta bem-sucedida à requisição:

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

Subcontas Ativas

Você pode pensar em subcontas como usuários em seu sistema. Podem estar ativas ou arquivadas. Podem ter limites por data, gasto e tráfego. Subcontas são a entidade principal para rastrear estatísticas.

Evite usar uma subconta para múltiplos usuários, pois eles compartilham senha de conexão e todos os limites!

Para listar subcontas ativas, use esta requisição. Parâmetros opcionais: p (página) e l (limite por página). Paginação ativa por padrão. Máximo de elementos por requisição (l) é 300.

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

Resposta bem-sucedida à requisição:

{
    "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 das subcontas são:


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

Subcontas Arquivadas

Você pode arquivar subcontas não utilizadas. Para listá-las, use esta requisição. Parâmetros opcionais: p (página) e l (limite por página). Paginação ativa por padrão. Máximo de elementos por requisição (l) é 300.

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

Resposta bem-sucedida à requisição:

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

Resposta bem-sucedida à requisição:

Você pode adicionar subcontas com limites e senha. Se não especificar senha, nosso sistema gerará uma

Defina sempre limites se revender nossos 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"
  }'
Abaixo está a descrição de cada campo da requisição:
{
  "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)
}'

Resposta bem-sucedida à requisição:

{
  "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 Subconta (Lista ou Porta)

Para editar uma subconta, você precisa do identificador de porta! A requisição é a mesma, mas inclua o campo 'port'

Se não especificar o campo 'port', uma nova subconta será gerada!

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"
  }'
Abaixo está a descrição de cada campo da requisição:
{
  "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)
}'

Resposta bem-sucedida à requisição:

{
  "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, Parar, Arquivar e Restaurar

Você pode gerenciar o status da subconta, o que irá parar/iniciar imediatamente seu funcionamento como 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"
  }'
Abaixo está a descrição de cada campo da requisição:
{
  "port": "YOUR_SUBACCOUNT_IDENTIFICATOR", // Identificator of your Subaccount. Mandatory field for edit subaccount.
  "command": "start" // Possible values of command: 'archive' 'restore' 'pause' 'start'
}'

Resposta bem-sucedida à requisição:

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

Gerar Links de Conexão Proxy

Para gerar links de proxy, especifique: subconta, tipo de link, quantidade (até 10000), tipo de rotação, país (obrigatório), estado (opcional) e cidade (opcional)

Atenção à URL da requisição. O identificador da subconta ('port') está presente na 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
}'
Abaixo está a descrição de cada campo da requisição:
{
  "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. 
}'

Resposta bem-sucedida à requisição:

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