什麼是 SNSSupporter API？
SNSSupporter 是一個 SMM panel，您可以從一個預付的美元餘額中購買 Instagram、YouTube、TikTok、Facebook、Telegram、Threads 和 X 的粉絲、讚、觀看次數和評論，每個訂單都會自動開始。API 讓您自己的 panel、機器人或腳本能像網站訂單表單一樣存取 148 項服務。
它遵循標準 SMM panel API v2 格式，因此已經為該格式構建的軟體只需更改 URL 和金鑰即可連接。每次呼叫都是一個 HTTP POST 到 https://snssupporter.site/api/v2，每個請求包含兩個欄位：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（費用，以 USD 計）、start_count（開始交付時的計數器）、status、remains（尚待交付的數量）和 currency。
status 欄位使用與訂單頁面相同的詞彙：Pending、In progress、Completed、Partial 和 Canceled。對於 Partial，remains 的退款已退回您的餘額；對於 Canceled，全額費用已退回。
發送 action=balance 以讀取當前餘額，例如 balance: 110.0000 和 currency: USD。在大批量下單前檢查，以便您的面板在資金不足時暫停新訂單。
對於輪詢，每筆未完成訂單每 10 到 30 分鐘檢查一次狀態即可滿足大多數服務需求。一旦狀態為 Completed、Partial 或 Canceled，請停止輪詢，因為這些是最終狀態，並將最終費用和 remains 與您的客戶訂單一起保存，以便您的記錄與訂單頁面一致。
| 欄位 | 範例值 | 意義 |
|---|---|---|
| charge | 3.3575 | 訂單費用（以 USD 計） |
| start_count | 1240 | 開始交付時的貼文按讚數 |
| status | In progress | 當前訂單狀態 |
| remains | 1800 | 尚待交付的數量 |
| currency | USD | 費用的貨幣 |
refill 動作如何運作？
具有補發期的服務在完成後接受補發請求：國際 Instagram 粉絲為 90 天，Telegram 成員為 60 天，YouTube 訂閱者、X 粉絲和 X 按讚為 30 天。services 動作會顯示 refill: true 表示這些項目。
發送 action=refill 並提供訂單 ID。回應會返回補發請求 ID，缺失的數量會再次發送到相同連結。在網站上，相同的請求是訂單頁面上的補發按鈕。
國際 Instagram 粉絲在交付完成 24 小時後符合補發資格。常見的經銷商設置是每晚檢查近期粉絲訂單的計數，並在計數低於 start_count 加上數量時發送補發。
如何從每 1,000 的價格計算成本和利潤？
訂單的費用是價格乘以數量除以 1,000。套裝是例外：其價格是套裝的價格。
範例：Telegram 成員 (#1134) 的價格為 $0.4440。客戶訂購 10,000 名成員，因此費用為 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 的餘額，這大約可支付 1,770,000 名 Instagram 粉絲，每 1,000 名粉絲價格為 $0.7059，服務編號為 #1001。
餘額用於 SNSSupporter 的訂單，部分和取消的訂單退款會自動返還到餘額中，因此資金隨時可用於下一次 API 呼叫。