ビスたん配信視聴ツール

ビスたん配信スパチャ検索API リファレンス

ビスたん配信のスーパーチャットを投稿者名・メッセージ本文で部分一致検索する公開 API です。 検索結果には紐付く配信のタイトルと配信日も含まれます。

配信開始当初にメンバーシップ限定配信だった配信のスパチャは収集対象外のため、本 API では取得できません。

エンドポイント概要

クエリパラメータ

※ user_name と message はどちらか一方は必ず指定してください。両方空の場合、ヒット件数 0 の空結果が返ります。

レスポンス (成功時 HTTP 200)

{
  "status": "success",
  "data": {
    "messages": [
      {
        "id": "ChwKGkNKLXdyLW5zdDRNRENoWndSN2dDZXdBdw==",
        "video_id": "dQw4w9WgXcQ",
        "user_name": "Jane Doe",
        "message": "Great stream!",
        "amount_display": "\u00a5500",
        "amount_micros": 500000000,
        "currency": "JPY",
        "tier": 3,
        "created_at": "2026-04-10 14:30:15",
        "stream_title": "Morning broadcast #42",
        "stream_date": "2026-04-10"
      }
    ],
    "totalCount": 142,
    "totalPages": 3
  }
}

レスポンスフィールド: トップレベル

data オブジェクト

data.messages 配列の各要素

エラーレスポンス

サーバー内部でエラーが発生した場合、HTTP 500 と共に以下の形式の JSON を返します。

{
  "status": "error",
  "message": "Internal Server Error"
}

レート制限超過時は HTTP 429 が返ります (こちらはボディなし)。

使用例

curl "https://bistan-tool.com/api/super_chat.php?user_name=Jane&page=1&sort=desc"

const params = new URLSearchParams({
    user_name: "Jane",
    page: "1",
    sort: "desc",
});

const res = await fetch(`https://bistan-tool.com/api/super_chat.php?${params}`);
const json = await res.json();

if (json.status === "success") {
    console.log(`${json.data.totalCount} 件ヒット`);
    for (const msg of json.data.messages) {
        console.log(`[${msg.stream_date}] ${msg.user_name}: ${msg.message}`);
    }
}

import requests

res = requests.get(
    "https://bistan-tool.com/api/super_chat.php",
    params={"user_name": "Jane", "page": 1, "sort": "desc"},
)
res.raise_for_status()
body = res.json()

if body["status"] == "success":
    print(f'{body["data"]["totalCount"]} 件ヒット')
    for msg in body["data"]["messages"]:
        print(f'[{msg["stream_date"]}] {msg["user_name"]}: {msg["message"]}')

注意事項

• user_name と message の両方が空の場合は、全件スキャン防止のため空結果が返ります。
• 配信開始当初にメンバーシップ限定配信だった配信のスパチャは収集対象外のため、本 API からは取得できません。
• 本 API は 30 リクエスト / 5 秒 / IP のレート制限が設定されています。超過時は HTTP 429 が返ります (運用状況に応じて値を変更する場合があります)。
• stream_title / stream_date は通常は非 null ですが、紐付く配信データが見つからない場合は null になる可能性があります。
• CORS について
  ブラウザ文脈において任意オリジンからのクロスオリジンアクセスを許可しています (Access-Control-Allow-Origin: *)。curl や Python スクリプト、サーバー間通信など非ブラウザクライアントは、そもそもブラウザの同一オリジンポリシーの対象外のため、CORS 設定の有無に関係なく利用可能です。

関連リンク

• ビスたん配信一覧API リファレンス