ビスたん配信視聴ツール

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

スパチャデータが保存されている配信の一覧をページネーション付きで取得する公開 API です。 配信日 (stream_date) 順にソートされます。

配信開始当初にメンバーシップ限定配信だった配信は本 API のレスポンスから除外されます。

エンドポイント概要

クエリパラメータ

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

{
  "status": "success",
  "data": {
    "streams": [
      {
        "video_id": "dQw4w9WgXcQ",
        "nth_time": "\u7b2c42\u56de",
        "title": "Morning broadcast #42",
        "scheduled_start_time": "2026-04-10 12:00:00",
        "is_members_only": 0,
        "stream_date": "2026-04-10"
      }
    ],
    "totalCount": 247,
    "totalPages": 13
  }
}

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

data オブジェクト

data.streams 配列の各要素

エラーレスポンス

パラメータに配列が渡される等、入力の型が不正な場合、HTTP 422 を返します。errors にはフィールドごとのエラー詳細が含まれます。

{
  "status": "error",
  "message": "Validation Error",
  "errors": {
    "page": ["pageの形式が不正です。"]
  }
}

GET / OPTIONS 以外の HTTP メソッドでリクエストした場合、HTTP 405 と共に以下の形式の JSON を返します。

{
  "status": "error",
  "message": "Method Not Allowed"
}

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

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

サーバーメンテナンス中は HTTP 502 が返る、または接続自体に失敗する場合があります (HTTP 502 のボディは JSON ではなく HTML)。時間をおいて再度リクエストしてください。

使用例

curl "https://bistan-tool.com/api/v1/saved-live-stream/?page=1&sort=desc"

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

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

if (json.status === "success") {
    console.log(`全 ${json.data.totalCount} 配信 / ${json.data.totalPages} ページ`);
    for (const stream of json.data.streams) {
        console.log(`[${stream.stream_date}] ${stream.title} (${stream.video_id})`);
    }
}

import requests

res = requests.get(
    "https://bistan-tool.com/api/v1/saved-live-stream/",
    params={"page": 1, "sort": "desc"},
)
res.raise_for_status()
body = res.json()

if body["status"] == "success":
    print(f'全 {body["data"]["totalCount"]} 配信 / {body["data"]["totalPages"]} ページ')
    for stream in body["data"]["streams"]:
        print(f'[{stream["stream_date"]}] {stream["title"]} ({stream["video_id"]})')

注意事項

• 配信開始当初にメンバーシップ限定配信だった配信はレスポンスにも totalCount にも含まれません。
• 配信開始当初にメンバーシップ限定配信だった配信のスパチャは収集対象外のため、ビスたん配信スパチャ検索API からも取得できません。
• nth_time / title / scheduled_start_time は過去に登録された配信では null の場合があります。
• 本 API にはレート制限は設定されていません (運用状況に応じて将来追加する場合があります)。
• CORS について
  ブラウザ文脈において任意オリジンからのクロスオリジンアクセスを許可しています (Access-Control-Allow-Origin: *)。curl や Python スクリプト、サーバー間通信など非ブラウザクライアントは、そもそもブラウザの同一オリジンポリシーの対象外のため、CORS 設定の有無に関係なく利用可能です。

関連リンク

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