Skip to content
Jochen Niebuhr edited this page Apr 11, 2015 · 1 revision

GET /api/v1/streams/live

Get a response containing live streams.

Response

{
  "data": [
    {
      "actual_start_time": "Sat, 11 Apr 2015 17:08:35 GMT", 
      "id": 3798, 
      "scheduled_start_time": null, 
      "site": "twitch_stream", 
      "title": "Indie MMORPG - Day 42 of 92 - Player Towns", 
      "url": "http://www.twitch.tv/ftostaff", 
      "user": "Rawrapanda", 
      "viewers": 8
    }, 
    {
      "actual_start_time": "Sat, 11 Apr 2015 14:15:01 GMT", 
      "id": 3397, 
      "scheduled_start_time": null, 
      "site": "twitch_stream", 
      "title": "Side Project Saturday | Zombie Dating Sim | Day 5", 
      "url": "http://www.twitch.tv/whilke", 
      "user": "whilke", 
      "viewers": 74
    }
  ], 
  "info": {
    "status": 200
  }
}

GET /api/v1/streams/upcoming

Get a response containing upcoming streams

Response

{
  "data": [
    {
      "actual_start_time": null, 
      "id": 6566, 
      "scheduled_start_time": "Sat, 11 Apr 2015 17:00:00 GMT", 
      "site": "twitch_stream", 
      "title": "Ep. 12 - Three Doors - Progression, Google Ads Integration", 
      "url": "http://www.twitch.tv/coffeewithcross", 
      "user": "HermitDesigner", 
      "viewers": null
    }
  ], 
  "info": {
    "status": 200
  }
}

GET /api/v1/streams/completed

Get a response containing completed streams

Response

{
  "data": [
    {
      "actual_start_time": "Sat, 11 Apr 2015 17:08:35 GMT", 
      "id": 3798, 
      "scheduled_start_time": null, 
      "site": "twitch_stream", 
      "title": "Indie MMORPG - Day 42 of 92 - Player Towns", 
      "url": "http://www.twitch.tv/ftostaff", 
      "user": "Rawrapanda", 
      "viewers": null
    }, 
    {
      "actual_start_time": "Sat, 11 Apr 2015 14:15:01 GMT", 
      "id": 3397, 
      "scheduled_start_time": null, 
      "site": "twitch_stream", 
      "title": "Side Project Saturday | Zombie Dating Sim | Day 5", 
      "url": "http://www.twitch.tv/whilke", 
      "user": "whilke", 
      "viewers": null
    }
  ], 
  "info": {
    "status": 200
  }
}

GET /api/v1/streams/{stream_id}

Get information on the stream with the specified ID

Response

{
  "data": {
    "actual_start_time": "Sat, 11 Apr 2015 17:08:35 GMT", 
    "id": 3798, 
    "scheduled_start_time": null, 
    "site": "twitch_stream", 
    "title": "Indie MMORPG - Day 42 of 92 - Player Towns", 
    "url": "http://www.twitch.tv/ftostaff", 
    "user": "Rawrapanda", 
    "viewers": 9
  }, 
  "info": {
    "status": 200
  }
}

GET /api/v1/streamers

Get a list of streamers

Response

{
  "data": [
    {
      "name": "glitterofhyad", 
      "twitch": "glitterofhyad", 
      "youtube": null
    }, 
    {
      "name": "Ryan_Collins", 
      "twitch": "frinlet", 
      "youtube": null
    }, 
    {
      "name": "Inateno", 
      "twitch": "inateno", 
      "youtube": null
    }, 
    {
      "name": "mrnosuch", 
      "twitch": "mrnosuch", 
      "youtube": null
    }
  ], 
  "info": {
    "status": 200
  }
}

GET /api/v1/streamers/{name}

Get information about a streamer

Response

{
  "data": {
    "name": "Ryan_Collins", 
    "twitch": "frinlet", 
    "youtube": null
  }, 
  "info": {
    "status": 200
  }
}

GET /api/v1/streamers/{name}/upcoming

Get the upcoming streams of a specific user

###Response

{
  "data": [
    {
      "actual_start_time": "Fri, 10 Apr 2015 13:35:17 GMT", 
      "id": 3399, 
      "scheduled_start_time": null, 
      "site": "twitch_stream", 
      "title": "Developing Frinlet (WebGL, custom engine)", 
      "url": "http://www.twitch.tv/frinlet", 
      "user": "Ryan_Collins", 
      "viewers": null
    }
  ], 
  "info": {
    "status": 200
  }
}

GET /api/v1/streamers/{name}/live

Get the current stream that is being streamed from a user

###Response

{
  "data": [
    {
      "actual_start_time": "Fri, 10 Apr 2015 13:35:17 GMT", 
      "id": 3399, 
      "scheduled_start_time": null, 
      "site": "twitch_stream", 
      "title": "Developing Frinlet (WebGL, custom engine)", 
      "url": "http://www.twitch.tv/frinlet", 
      "user": "Ryan_Collins", 
      "viewers": null
    }
  ], 
  "info": {
    "status": 200
  }
}

GET /api/v1/streamers/{name}/completed

Get the completed streams of a specific user

Response

{
  "data": [
    {
      "actual_start_time": "Fri, 10 Apr 2015 13:35:17 GMT", 
      "id": 3399, 
      "scheduled_start_time": null, 
      "site": "twitch_stream", 
      "title": "Developing Frinlet (WebGL, custom engine)", 
      "url": "http://www.twitch.tv/frinlet", 
      "user": "Ryan_Collins", 
      "viewers": null
    }
  ], 
  "info": {
    "status": 200
  }
}