什麼是 SNSSupporter API？
SNSSupporter 是一個 SMM 面板，你可以從一個預付 USD 餘額中購買 Instagram、YouTube、TikTok、Spotify、Twitch、Telegram、LinkedIn 等 20 多個平台的粉絲、點讚、觀看次數和評論，每個訂單自動開始。API 讓你的面板、機器人或腳本擁有與網站訂單表相同的 148 項服務訪問權限。
它遵循標準 SMM 面板 API v2 格式，因此已經為該格式構建的軟件只需更改 URL 和密鑰即可連接。每次調用都是對 https://snssupporter.site/api/v2 的 HTTP POST，每個請求包含兩個字段：key 和 action。
通過 API 下的訂單會與網站上的訂單一樣從同一餘額中扣除，並顯示在同一 Orders 頁面上。完整的參數參考在 API Docs 頁面上。
如何獲取 API 密鑰？
使用您的 access token 登錄，打開您帳戶的 Developer 頁面並創建一個 API 密鑰。密鑰只顯示一次，因此請立即將其複製到您的服務器配置或密碼管理器中。
僅將密鑰保存在您的服務器上。從瀏覽器或移動應用程序調用會暴露它，因此請通過您自己的後端路由客戶訂單，並從那裡調用 API。
一個良好的集成在調用 add 之前會檢查三件事：連結格式是否符合服務（用戶名、帖文連結、視頻連結或頻道連結），數量是否在 services 中的 min 和 max 範圍內，以及餘額是否足夠支付費用。在您這邊拒絕一個錯誤的訂單比等待錯誤對您的客戶來說更快。
如果密鑰洩露，請在 Developer 頁面上創建一個新密鑰並在您的配置中替換它。新密鑰將接管帳戶的所有 API 訪問權限。當調用失敗時，回應會帶有一個 error 字段，包含簡短訊息，例如無效的密鑰、未知的服務 ID 或餘額不足以支付費用；將其與請求一起記錄，以便您可以修復原因。
- Endpoint: https://snssupporter.site/api/v2
- 方法：POST
- 表單欄位 (key, action 及該 action 的欄位)
- 回應: JSON
- 貨幣: USD, 價格日期 2026-11-06
API 支援哪些動作？
API 有五個動作。每個動作都作為 action 欄位與您的 key 一起發送，再加上表格中列出的欄位。
每個整合都從 services 開始以載入目錄，然後使用 add 下單，status 追蹤訂單，balance 查看資金，並在符合條件的已完成訂單上使用 refill。
| 動作 | 額外欄位 | 回傳內容 |
|---|---|---|
| services | 無 | 服務列表，包含 ID、名稱、類別、價格、最小數量、最大數量及 refill |
| add | service, link, quantity (或 comments) | 新訂單 ID |
| status | order | 費用、起始數量、狀態、剩餘數量及貨幣 |
| balance | 無 | 當前餘額及貨幣 |
| refill | order | 符合條件的已完成訂單的 refill 請求 ID |
services 動作回傳什麼？
services 動作為每個服務回傳一個條目。將服務 ID、價格、最小數量及最大數量儲存在您的資料庫中，並每日更新，以便您的面板始終顯示當前限制。
價格為每 1,000 單位的美元價格。對於套裝項目，例如 Instagram Auto Likes, 50 per Post, 30 Days (#1020)，價格為一個套裝的價格，且最小數量與最大數量均為 1。
以下是 Instagram Followers, Real, International 的一個條目，逐欄位寫出。
| 欄位 | 範例值 | 意義 |
|---|---|---|
| service | 1001 | 用於 add 動作的服務 ID |
| name | Instagram Followers, Real, International | 服務名稱 |
| category | 服務群組 | |
| rate | 0.7059 | 每 1,000 單位的美元價格 |
| min | 100 | 每筆訂單的最小數量 |
| max | 1000000 | 每單最大數量 |
| refill | true | 已完成訂單可享補貨 |
如何使用 add 動作下單？
發送 action=add 並附上服務 ID、連結及數量。連結格式與網站相同：Instagram 追蹤者使用用戶名，讚好使用貼文或 Reel 連結，YouTube 觀看次數使用影片連結，YouTube 訂閱者使用頻道連結。
對於自訂留言服務，例如 YouTube 留言、自訂文字、國際 (#1115)，請發送 comments 欄位而非數量。每行一條留言，以換行分隔；行數即為數量。
成功呼叫會返回新訂單 ID，例如 order: 84172630。請將其與您的客戶訂單一同保存，因為狀態和補貨會使用它。
| 欄位 | 範例值 |
|---|---|
| key | 您的 API 密鑰 |
| action | add |
| service | 1004 |
| link | https://www.instagram.com/p/C8xYz12AbCd/ |
| quantity | 5000 |
| Response | order: 84172630 |
如何追蹤訂單及餘額？
發送 action=status 並將 order 設為 add 的 ID。回應包含五個欄位：charge（以美元計的成本）、start_count（開始交付時的計數器）、status、remains（尚待交付的數量）及 currency。
status 欄位使用與訂單頁面相同的詞語：Pending、In progress、Completed、Partial 及 Canceled。對於 Partial，remains 的退款已退回您的餘額；對於 Canceled，全額 charge 已退回。
發送 action=balance 以讀取當前餘額，例如 balance: 110.0000 及 currency: USD。在大量訂單前請檢查，以便您的面板在資金不足時暫停新訂單。
對於輪詢，每個未完成訂單每 10 至 30 分鐘檢查一次狀態已足夠。一旦狀態為 Completed、Partial 或 Canceled 時請停止輪詢，因為這些是最終狀態，並將最終 charge 及 remains 與您的客戶訂單一同保存，以便您的記錄與訂單頁面一致。
| 欄位 | 範例值 | 意義 |
|---|---|---|
| charge | 3.3575 | 訂單成本（以美元計） |
| start_count | 1240 | 開始交付時的貼文讚好數 |
| status | In progress | 當前訂單狀態 |
| remains | 1800 | 尚待交付的數量 |
| currency | USD | charge 的貨幣 |
refill 動作如何運作？
設有補貨期的服務在完成後接受補貨請求：國際 Instagram 追蹤者為 90 天，Telegram 成員為 60 天，YouTube 訂閱者、X 追蹤者及 X 讚好為 30 天。services 動作會顯示 refill: true 以標示這些項目。
發送 action=refill 並附上訂單 ID。回應會返回補貨請求 ID，缺失的數量會再次發送至同一連結。在網站上，相同的請求即為訂單頁面上的 Refill 按鈕。
國際 Instagram 追蹤者在交付完成 24 小時後符合資格。常見的轉售商設置是每晚檢查近期追蹤者訂單的計數，並在計數低於 start count 加上數量時發送補貨。
如何從每 1,000 的價格計算成本及利潤？
訂單的 charge 是價格乘以數量除以 1,000。套餐是例外：其價格即為一個套餐的價格。
示例：Telegram 成員 (#1134) 的價格為 $0.4440。客戶訂購 10,000 名成員，因此 charge 為 10,000 / 1,000 x 0.4440 = $4.44。如果您的面板以每 1,000 $1.00 出售此服務，客戶支付 $10.00，您的利潤為 $5.56。
第二示例：Instagram 讚好、真實、國際 (#1004) 的價格為 $0.0462。5,000 個讚好的訂單成本為 5 x 0.0462 = $0.2310。以每 1,000 $0.15 出售，客戶支付 $0.75，單筆訂單的利潤為 $0.5190。
| 服務 | 每 1,000 個的價格 | 數量 | 費用 | 以每 1,000 個出售 | 利潤 |
|---|---|---|---|---|---|
| #1134 Telegram 會員 | $0.4440 | 10,000 | $4.4400 | $1.00 | $5.5600 |
| #1004 Instagram 讚好 | $0.0462 | 5,000 | $0.2310 | $0.15 | $0.5190 |
| #1121 TikTok 觀看次數 | $0.0938 | 50,000 | $4.6900 | $0.20 | $5.3100 |
| #1001 Instagram 追蹤者 | $0.7059 | 2,000 | $1.4118 | $2.00 | $2.5882 |
如何為 API 帳戶充值？
API 訂單與網站一樣從預付的美元餘額中扣除。通過 PayGate 加密貨幣結帳從您的帳戶充值，提供 12 種方式，包括 USDT、USDC、比特幣、以太坊、BNB 和 Solana，每次支付金額為 $30 至 $5,000。
首次充值可獲得一次性獎勵：$100 以上 +10%，$300 以上 +15%，$500 以上 +20%，$1,000 以上 +25%。一個從 $1,000 開始的轉銷商將獲得 $1,250 的餘額，這大約涵蓋了 #1001 上的 1,770,000 Instagram 粉絲，每個 $0.0007059。
餘額用於 SNSSupporter 的訂單，部分和取消的訂單退款會自動返還到餘額中，以便資金隨時可用於下一次 API 調用。