GET /shows

Get shows from all users.

This method returns optionally filtered shows paginated in groups of 50. Shows are returned in reverse chronological order.

To filter shows by user see the similar: GET /users/:id/shows.

Resource URL

https://api.chew.tv/v1/shows
Parameters Example
Optional Parameters
page

Retreive given page in paginated result set (defaults to 1)

2
filter

Filter show by name

Practice
slug

Find show with the exact slug provided

practice
from

Find shows started/starting since this value

7 days ago, 2016-01-01 20:30
to

Find shows started/starting before this value

7 days, 2018-01-01
scheduled

Fetch only scheduled shows (true) or only complete shows (false)

true
live

Fetch only live or not-live shows

true
archive

Fetch only archived or not-archived shows

true
featured

Fetch only featured or not-featured shows. A featured show is one that appears on the top of the Chew homepage.

false
radio

Fetch only radio or not-radio shows. Radio shows are 24 hour shows that can only be created by selected users but never archive.

false
tag

Find shows tagged with a given tag

deep house

Response

Successful requests will return the following JSON structure:

Properties
page

Current page number

next_url

URL to next page of results (null if page > pages)

prev_url

URL to previous page of results (null if page is 1)

pages

Number of pages in the current result set

count

Number of shows in the current result set

shows

Array of Shows

Example data
{
  "page": 1,
  "next_url": "http://api.chew.tv/v1/shows?tag=dubstep&page=2",
  "prev_url": null,
  "pages": 15,
  "count": 293,
  "shows": [
    {
      "id": 58058,
      "url": "http://chew.tv/vr/vibrating-room-98-genoc1de",
      "object_url": "http://api.chew.tv/v1/shows/58058",
      "slug": "vibrating-room-98-genoc1de",
      "name": "Vibrating Room 98 - Genoc1de",
      "description": "A special dubplate transaction, deep vibes of  Dubstep, Garage,  and  Future Dub and much more. Special guest - Distant Roots a.k.a. Genoc1de from Vologda.\n\nsoundcloud.com/genoc1de",
      "start": "2015-12-03 18:40:39",
      "created_at": "2015-12-03 13:26:43",
      "duration": 10116,
      "live": false,
      "complete": true,
      "archive": true,
      "featured": false,
      "upload": false,
      "private": false,
      "radio": false,
      "off": false,
      "comments_count": 71,
      "favorites_count": 0,
      "thumbnail_label": "02:48:36",
      "video_url": "http://video.cdn.chew.tv/vr-zX29X/vr-zX29X_all.m3u8",
      "audio_url": "http://video.cdn.chew.tv/vr-zX29X/vr-zX29X_audio.m3u8",
      "image_url": "http://image.cdn.chew.tv/vr-zX29X/vr-zX29X.png?1455212792",
      "gif_url": null,
      "embed_code": "<div class=\"chew\" data-uri=\"vr/vibrating-room-98-genoc1de\"></div><script src=\"//chew.tv/assets/js/embed.js\"></script>",
      "tags": [
        {
          "name": "Dubstep",
          "slug": "dubstep"
        },
        {
          "name": "garage",
          "slug": "garage"
        },
        {
          "name": "dub",
          "slug": "dub"
        },
        {
          "name": "breakbeat",
          "slug": "breakbeat"
        },
        {
          "name": "vibrating room",
          "slug": "vibrating-room"
        },
        {
          "name": "future dub",
          "slug": "future-dub"
        }
      ],
      "user": {
        "id": 26134,
        "url": "http://chew.tv/vr",
        "object_url": "http://api.chew.tv/v1/users/26134",
        "slug": "vr",
        "name": "Igor Inkey",
        "location": "Moscow, Russia",
        "description": null,
        "created_at": "2015-09-18 06:05:50",
        "dj": true,
        "producer": false,
        "featured": false,
        "image_url": "http://image.cdn.chew.tv/vr/vr.png?1448870444",
        "cover_url": "http://image.cdn.chew.tv/vr/cover/vr_1240.png?1448870444"
      }
    },
    {
      "id": 58029,
      "url": "http://chew.tv/sixsunsets/six-sunsets-live-on-subfm",
      "object_url": "http://api.chew.tv/v1/shows/58029",
      "slug": "six-sunsets-live-on-subfm",
      "name": "Six Sunsets - Live on Sub.fm",
      "description": "Six Sunsets Show",
      "start": "2015-12-02 22:02:09",
      "created_at": "2015-12-02 21:52:40",
      "duration": 5880,
      "live": false,
      "complete": true,
      "archive": true,
      "featured": false,
      "upload": false,
      "private": false,
      "radio": false,
      "off": false,
      "comments_count": 0,
      "favorites_count": 0,
      "thumbnail_label": "01:38:00",
      "video_url": "http://video.cdn.chew.tv/sixsunsets-gnRw2/sixsunsets-gnRw2_all.m3u8",
      "audio_url": "http://video.cdn.chew.tv/sixsunsets-gnRw2/sixsunsets-gnRw2_audio.m3u8",
      "image_url": "http://image.cdn.chew.tv/sixsunsets-gnRw2/sixsunsets-gnRw2.png?1449139010",
      "gif_url": null,
      "embed_code": "<div class=\"chew\" data-uri=\"sixsunsets/six-sunsets-live-on-subfm\"></div><script src=\"//chew.tv/assets/js/embed.js\"></script>",
      "tags": [
        {
          "name": "fatkidonfire",
          "slug": "fatkidonfire"
        },
        {
          "name": "Dubstep",
          "slug": "dubstep"
        },
        {
          "name": "six sunsets",
          "slug": "six-sunsets"
        },
        {
          "name": "sub fm",
          "slug": "sub-fm"
        }
      ],
      "user": {
        "id": 5611,
        "url": "http://chew.tv/sixsunsets",
        "object_url": "http://api.chew.tv/v1/users/5611",
        "slug": "sixsunsets",
        "name": "Six Sunsets",
        "location": "Newcastle-upon-Tyne, UK",
        "description": "Six Sunsets is a duo comprising of producers Ekula and The Physical Republic. Their wide-ranging bass-driven DJ sets display a range of UK-flavoured bass music. Their debut EP was released through London-based label FatKidOnFire in March 2015, receiving support from Coki of Digital Mystikz, Nick Roberts on BBC Radio, Conscious Pilot, DJ Raggs and Lojt amongst many others. They have performed across the UK, supporting acts of various calibres, and plan release their second EP this Summer.\n\nThey also recently played a launch party for music-streaming platform Chew.tv, supporting Taiko and Dark Harmonics in collaboration with popular London blog and label FatKidOnFire - the video archive of the set can be found here: http://chew.tv/chew/chew-x-fkof-x-standard-procedure-x-exit-secret-party\n",
        "created_at": "2015-02-01 22:07:01",
        "dj": true,
        "producer": false,
        "featured": false,
        "image_url": "http://image.cdn.chew.tv/sixsunsets/sixsunsets.png?1439842602",
        "cover_url": "http://image.cdn.chew.tv/sixsunsets/cover/sixsunsets_1240.png?1439842602"
      }
    },
    [...]
  ]
}