メインコンテンツへスキップ

ViewerBoss API

TwitchとKickチャンネルの視聴者タスクを、ご自身のコードから管理できます。

POST/api/viewers/task
fetch('https://api.viewerboss.com/api/viewers/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    platform: "twitch",
    channel: "exampleChannel",
    count: 1300,
    delay: 50
  })
})
{
  "message": "Success",
  "taskId": 4356
}

認証

すべてのリクエストで、AuthorizationヘッダーにAPIキーを含めてください。

Authorization: Bearer YOUR_API_KEY

エンドポイント

  • TwitchまたはKickチャンネルに新しい視聴者タスクを作成します。

    リクエスト例

    fetch('https://api.viewerboss.com/api/viewers/task', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        platform: "twitch",
        channel: "exampleChannel",
        count: 1300,
        delay: 50
      })
    })

    レスポンス例

    {
      "message": "Success",
      "taskId": 4356
    }
  • TwitchとKickのすべての視聴者タスクを返します。実行中のタスクだけを取得するには onlyWorking=true を追加します。

    リクエスト例

    fetch('https://api.viewerboss.com/api/viewers/tasks?onlyWorking=true', {
      method: 'GET',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    })

    レスポンス例

    [
      {
        "id": 4356,
        "platform": "twitch",
        "channel": "exampleChannel",
        "count": 1300,
        "status": "active"
      }
    ]
  • IDを指定して、1件の視聴者タスクの詳細を返します。

    リクエスト例

    fetch('https://api.viewerboss.com/api/viewers/task/4356', {
      method: 'GET',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    })

    レスポンス例

    {
      "id": 4356,
      "platform": "twitch",
      "channel": "exampleChannel",
      "count": 1300,
      "status": "active"
    }
  • IDを指定して視聴者タスクを削除します。

    リクエスト例

    fetch('https://api.viewerboss.com/api/viewers/task/4356', {
      method: 'DELETE',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    })

    レスポンス例

    {
      "message": "Task deleted successfully."
    }
  • 実行中のタスクの視聴者数を増やします。

    リクエスト例

    fetch('https://api.viewerboss.com/api/viewers/task/13082/increase-viewers?count=50&delay=100', {
      method: 'PUT',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    })

    レスポンス例

    {
      "message": "Viewer count increased successfully.",
      "newCount": 1350
    }
  • 実行中のタスクの視聴者数を減らします。

    リクエスト例

    fetch('https://api.viewerboss.com/api/viewers/task/1522/decrease-viewers?count=100&delay=100', {
      method: 'PUT',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    })

    レスポンス例

    {
      "message": "Viewer count decreased successfully.",
      "newCount": 1200
    }

レート制限

APIキーごとの上限は次のとおりです。

  • 1分あたり100リクエスト
  • 1時間あたり1,000リクエスト
  • 1日あたり10,000リクエスト

上限を超えたリクエストには HTTP 429(Too Many Requests)が返されます。上限を引き上げたい場合はサポートにお問い合わせください。

APIについてお困りですか?

ViewerBoss APIをアプリに組み込む方法は、サポートチームがご案内します。

無料で試す - カード登録不要

15人の視聴者 + 15人のチャッターを60分間お試しいただけます。ダッシュボードもフル機能利用可能。納得してからお支払いください。

twitch.tv/

15人の無料視聴者 · カード不要 · ダウンロード不要