SuperNova Proxy SuperNova
ログイン 登録 →

開発者向けAPIドキュメント

APIを使用して作業効率を向上させるか、再販目的でご利用ください

開発者向けAPIドキュメント

当サービスのAPIを使用することで、システム連携やブランド再販が可能です。API対応ソフトウェアをお持ちの場合や、独自ブランド/ショップでのプロキシ再配信に最適です。まずアカウントにログインし、ページ上部のフォームからAPIキーを生成してください。APIキーはすべてのAPIリクエストで必須です。APIキーは1アカウントにつき1つのみ保持可能で、随時更新できます（旧キーは自動無効化されます）。

推奨事項:

1. 国・州/地域・都市情報は1分に1回以上更新するか、プロキシリンク作成/更新前必ず取得してください

2. リンク形式の更新は稀です。特別な形式が必要な場合はサポートへお問い合わせください

3. サブアカウントの制限を無視しないでください！プロキシリンクを販売する際は必ず利用制限を設定しないと、アカウント残高からの不正利用リスクがあります

4. 独自ドメインを使用可能です：接続ゲートウェイのIPアドレスを取得し、DNSレコードを更新してください（IPv4のみ対応、IPv6接続は遮断されます）。詳細はサポートまで。

基本情報

リクエストヘッダーにAPIキーを必須追加:

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

エラー時はHTTPステータスコード・簡易説明と'success'=falseが返されます:

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

セキュリティのため全APIエンドポイントにレート制限が適用されます。過剰なリクエストは429エラーを引き起こします。制限緩和が必要な場合はサポートへ。応答ヘッダーで残リクエスト数を確認可能:

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

アカウント残高

現在の残高を取得するリクエスト:

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

リクエストに対する成功応答の例:

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
}

利用可能な国

全プロキシタイプの国リストを取得（タイプ別フィルタリング不可）

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

リクエストに対する成功応答の例:

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

利用可能な州/地域と国

指定国の州/地域リストを取得（プロキシタイプ混合、フィルタ不可）。国の指定必須

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

州ID指定で都市をフィルタ可能:

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

リクエストに対する成功応答の例:

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

プロキシリンク形式

プロキシリンク形式リストを取得（リンク生成時にIDが必要）

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

リクエストに対する成功応答の例:

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

有効なサブアカウント

サブアカウント＝ユーザーアカウント。有効/アーカイブ状態・日数/支出/トラフィック制限を設定可能。統計管理の主要エンティティです

異なるユーザーに同一サブアカウントを使用しないでください！接続パスワードと制限が共有されます

有効サブアカウントリスト取得（オプション: p=ページ, l=1ページあたりの制限）。最大300件/リクエスト

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

リクエストに対する成功応答の例:

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

サブアカウントのステータス:


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

アーカイブ済みサブアカウント

不要なサブアカウントをアーカイブ可能。取得時はp/lパラメータ使用可（最大300件/リクエスト）

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

リクエストに対する成功応答の例:

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

リクエストに対する成功応答の例:

制限とパスワードを指定して追加（パスワード未指定時は自動生成）

再販時は必ず制限を設定してください！

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"
  }'
各リクエストフィールドの説明:
{
  "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)
}'

リクエストに対する成功応答の例:

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

サブアカウント編集（リスト/ポート）

編集時はポートID必須（'port'フィールド追加）

'port'未指定時は新規サブアカウントが生成されます！

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"
  }'
各リクエストフィールドの説明:
{
  "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)
}'

リクエストに対する成功応答の例:

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

開始/停止/アーカイブ/復元

サブアカウントのステータスを即時変更（プロキシ動作に直接影響）

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"
  }'
各リクエストフィールドの説明:
{
  "port": "YOUR_SUBACCOUNT_IDENTIFICATOR", // Identificator of your Subaccount. Mandatory field for edit subaccount.
  "command": "start" // Possible values of command: 'archive' 'restore' 'pause' 'start'
}'

リクエストに対する成功応答の例:

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

プロキシ接続リンク生成

サブアカウント・リンクタイプ・数量（最大10000）・ローテーションタイプ・国（必須）・州（任意）・都市（任意）を指定

リクエストURLにサブアカウントID（'port'値）を含めてください！

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
}'
各リクエストフィールドの説明:
{
  "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. 
}'

リクエストに対する成功応答の例:

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