開発者とリセラー向け

SMMパネルAPI:注文を自動化

標準リセラーAPIでサービス一覧を取得し、注文を作成し、状態と残高を照会できます。エンドポイントは1つ、応答はJSONなので、お使いのパネルソフトウェアに数分でつながります。

エンドポイント1つ · アクション7種 · JSON応答

4.41,506件のレビュー

業界標準のリセラーAPI

このAPIは業界で広く使われている標準リセラー形式に沿っています。市販のパネルソフトウェアやスクリプトの多くは、APIのURLとキーを差し替えるだけでPanelFollowsで動きます。

エンドポイントは1つ

すべてのリクエストは1つのURLに送ります。追加のパスやバージョン管理は不要で、どの処理を行うかはactionパラメーターで決めます。

form-encodedのPOST

パラメーターはform-encodedのPOSTで送信し、JSONボディも受け付けます。標準的なHTTPライブラリ以外に特別なツールは要りません。

JSON応答

すべてのリクエストがJSONを返します。エラーはerrorフィールド1つで返るため、例外処理はシンプルで予測しやすくなります。

キーによる認証

認証に必要なのはkeyパラメーター1つだけです。署名やトークン、OAuthの実装は必要ありません。

POST https://panelfollows.com/api/v2
Content-Type: application/x-www-form-urlencoded

key=API_KEY&action=balance

# 応答
{ "balance": "25.4300", "currency": "USD" }

注文がパネル内をどう進むかはご利用の流れのページで、リセラーの仕組みはSMMリセラーパネルのページで説明しています。

対応アクション

APIは現在7つのアクションに対応しています。リクエストはすべて同じエンドポイントに送り、処理はactionパラメーターで選びます。

services

key, action

有効なサービスカタログを返します。サービスID、名称、カテゴリー、1000あたりの単価、最小と最大の数量に加え、補充、キャンセル、dripfeedの対応可否が含まれます。

add

key, action, service, link, quantity [, runs, interval]

新しい注文を作成し、その注文番号を返します。dripfeed対応のサービスではrunsとintervalを、カスタムコメントのサービスではcommentsパラメーターを使います。

status

key, action, order | orders

注文の詳細を返します。charge、start_count、状態、残りの数量remainsが含まれます。ordersパラメーターにカンマ区切りのリストを渡せば、複数の注文をまとめて照会できます。

balance

key, action

アカウントの残高をUSDで返します。注文の金額も同じ通貨で計算されます。

refill

key, action, order | orders

補充に対応したサービスの完了済み注文に補充リクエストを作成し、追跡用の補充IDを返します。複数の注文はカンマ区切りで送れます。

refill_status

key, action, refill | refills

補充リクエストの現在の状態を返します。refillsパラメーターで複数をまとめて照会できます。

cancel

key, action, orders

保留中または進行中の注文をキャンセルし、金額を残高に返金します。カンマ区切りで複数の注文番号を受け付けます。

注文の状態はPending、In progress、Completed、Partial、Canceledとして返されます。

APIを自社のソフトウェアに組み込むかわりに、出来上がった販売画面をお探しですか。子パネルのページをご覧ください

コード例

以下の例ではcurlを使っています。API_KEYの部分を、パネルで発行したキーに置き換えてください。

サービス一覧の取得

# サービス一覧を取得
curl -X POST https://panelfollows.com/api/v2 \
  -d "key=API_KEY" \
  -d "action=services"

# 応答
[
  {
    "service": "1201",
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "1.2000",
    "min": "10",
    "max": "100000",
    "refill": true,
    "cancel": true,
    "dripfeed": false
  }
]

注文の作成

# 新しい注文を作成
curl -X POST https://panelfollows.com/api/v2 \
  -d "key=API_KEY" \
  -d "action=add" \
  -d "service=1201" \
  -d "link=https://instagram.com/username" \
  -d "quantity=1000"

# 応答
{ "order": 23501 }

始め方

  1. 1

    無料アカウントを作る

    メールアドレスで数秒で登録できます。APIの利用はすべてのアカウントに追加費用なしで付いてきます。

  2. 2

    APIキーを発行する

    パネルのAPIページでワンクリックでキーを作成し、コピーできます。いつでも再発行できます。

  3. 3

    組み込む

    取得したキーでソフトウェアをエンドポイントに向け、サービス一覧を取得して、APIから最初の注文を出してみましょう。

キーの作成と管理はダッシュボードのAPIページから行えます。

APIキーは大切に保管を

APIキーはアカウントに代わって注文を出せるため、パスワードと同じように扱ってください。サーバー側だけで使い、公開リポジトリやクライアント側のコード、スクリーンショットには残さないようにしましょう。

キーが漏れたおそれがある場合は、パネルのAPIページでワンクリックで再発行できます。古いキーはその時点で無効になります。不正利用を防ぐため、APIはキーごとに1分あたり240リクエストに制限されています。

よくある質問

SMMパネルAPIは無料ですか?

はい。APIの利用はすべてのPanelFollowsアカウントに含まれており、追加料金や別プランはありません。お支払いいただくのは実際に出した注文のサービス料金だけです。

応答の形式は何ですか?

すべてのアクションがJSONを返します。残高と注文の金額はUSD建てで、エラーはerrorフィールド1つで返るため処理が簡単です。

既存のパネルスクリプトと互換性はありますか?

はい。このAPIは業界で広く使われている標準リセラー形式に沿っているため、市販のパネルソフトウェアやスクリプトの多くはAPIのURLとキーを更新するだけで済みます。

レート制限はありますか?

はい。APIキーごとに1分あたり240リクエストまで受け付け、超えた分はJSONのエラーメッセージとともに拒否されます。一般的な自動化の用途には十分な余裕があります。

APIからdripfeedや補充も使えますか?

はい。dripfeed対応のサービスではaddアクションにrunsとintervalのパラメーターを追加できます。補充対応のサービスではrefillアクションでリクエストを作成し、refill_statusで状況を追えます。

お客様のレビュー

このサービスを実際に使った方の体験を、ご本人の言葉で紹介します。

@yuta_tiktok

TikTok

TikTokの伸びが変わった

投稿直後に再生回数を入れておくと、おすすめに乗る確率が明らかに上がりました。同じ動画でも初速で結果が変わります。

田中

Instagram

リセラー運用が一気に楽に

APIキーを発行して自社パネルにつなぐまで15分ほどでした。注文ステータスもそのまま取得できるので、毎日の手作業の確認がほぼなくなっています。

@sns_lab_jp

Instagram

一括注文が便利すぎる

サービスID、リンク、数量を貼り付けて24件を一度に送れました。以前は1件ずつ入力して1時間かかっていた作業が数分で終わります。

岡本

YouTube

チャンネル登録者が増えた

登録者を1000人まで引き上げたところで、収益化の条件が現実的に見えてきました。3か月経ちますが減少もありません。

@growth_jp

リセラーとして本命

3社のパネルを比較しましたが、在庫の安定性と単価のバランスはここが一番でした。今は子パネルの導入も検討しています。

@カフェあおい

Instagram

お店のアカウントで利用

カフェの集客に使いました。来店につながったかまでは追えませんが、投稿への反応と問い合わせは確実に増えています。

今日からAPIで自動化を始める

無料アカウントを作り、APIキーを取得して、数分で自社のソフトウェアから最初の注文を出しましょう。

関連ページ