YogsDB API Documentation

All API requests should be made to the base URL of https://api.yogsdb.com/api/

URLs are pluralised so a request for a channel, whether you’re requesting one or many would be “channels”, not “channel”.

If you’re requesting all results, they’ll be in an array. If you’re requesting a specific object it will not be.

Paginated results return 25 values each for now. In future this will be configurable.

Please make sure you’ve read the Terms of Service first!

Channels

All

Request

https://api.yogsdb.com/api/channels

Return value

{
  "current_page": 1,
  "data": [
    {
      "id": 1,
      "youtube_id": "UCH-_hzb2ILSCo9ftVSnrCIQ",
      "title": "YOGSCAST Lewis & Simon",
      "description": "Minecraft and multiplayer comedy gaming with a drunken dwarf and a handsome spaceman! Join us as we laugh our way through the best, the worst and the funniest indie games, Minecraft mods, mini-games and adventure maps.\n\nYogscast official merchandise store: http:\/\/store.yogscast.com\/\nYogscast Games Store: http:\/\/games.yogscast.com\nTwitch Channel: http:\/\/twitch.tv\/yogscast\nYogscast Official Computers: http:\/\/www.chillblast.com\/yogscast\/",
      "created_at": "2017-03-11 18:59:12",
      "updated_at": "2017-07-09 17:34:28",
      "slug": "yogscast-lewis-simon",
      "view_count": 3610201471,
      "comment_count": 141287,
      "subscriber_count": 7325606,
      "video_count": 4010,
      "image": "https:\/\/cdn.yogsdb.com\/channel\/UCH-_hzb2ILSCo9ftVSnrCIQ.jpg"
    }
  ],
  "from": 1,
  "last_page": 31,
  "next_page_url": "https:\/\/api.yogsdb.com\/api\/channels?page=2",
  "path": "https:\/\/api.yogsdb.com\/api\/channels",
  "per_page": 1,
  "prev_page_url": null,
  "to": 1,
  "total": 31
}

Specific

 Request
https://api.yogsdb.com/api/channels/{id}

Return value

{
  "id": 1,
  "youtube_id": "UCH-_hzb2ILSCo9ftVSnrCIQ",
  "title": "YOGSCAST Lewis & Simon",
  "description": "Minecraft and multiplayer comedy gaming with a drunken dwarf and a handsome spaceman! Join us as we laugh our way through the best, the worst and the funniest indie games, Minecraft mods, mini-games and adventure maps.\n\nYogscast official merchandise store: http:\/\/store.yogscast.com\/\nYogscast Games Store: http:\/\/games.yogscast.com\nTwitch Channel: http:\/\/twitch.tv\/yogscast\nYogscast Official Computers: http:\/\/www.chillblast.com\/yogscast\/",
  "created_at": "2017-03-11 18:59:12",
  "updated_at": "2017-07-09 17:34:28",
  "slug": "yogscast-lewis-simon",
  "view_count": 3610201471,
  "comment_count": 141287,
  "subscriber_count": 7325606,
  "video_count": 4010,
  "image": "https:\/\/cdn.yogsdb.com\/channel\/UCH-_hzb2ILSCo9ftVSnrCIQ.jpg"
}

Videos

See also Filtering Videos

All

Request

https://api.yogsdb.com/api/videos

Return value

{
  "current_page": 1,
  "data": [
    {
      "id": 32859,
      "youtube_id": "LTSTv5cH-dE",
      "title": "Are These REALLY The Most Addictive Mobile Games?",
      "description": "It's time to find out if these are REALLY the most addictive mobile games on the app store right now. You all seem to think so, so I put it to the test myself!\n\nDownload all the games HERE:\n\n\n\n\u2665 Subscribe: http:\/\/yogsca.st\/TappSub \u2665\n\n\u25ba Like Yogscast? Buy our stuff here: http:\/\/store.yogscast.com\/ \u25c4\n\nWebsite: http:\/\/www.yogscast.com\nTwitch Channel: http:\/\/www.twitch.tv\/yogscast\/\nYogscast Games Store: http:\/\/games.yogscast.com\n\nInstagram: http:\/\/instagram.com\/yogscast \nReddit: http:\/\/www.reddit.com\/r\/yogscast\nTwitter: https:\/\/twitter.com\/WatchTAP\nYogscast FAQ: http:\/\/www.yogscast.com\/about\/faq\/\n\nPowered by Chillblast: http:\/\/www.chillblast.com\/yogscast\nMailbox: The Yogscast, PO Box 3125 Bristol BS2 2DG\nBusiness enquiries: [email protected]",
      "created_at": "2017-07-09 17:34:42",
      "updated_at": "2017-07-09 17:34:42",
      "channel_id": 4,
      "slug": "are-these-really-the-most-addictive-mobile-games",
      "upload_date": "2017-07-09 17:00:04",
      "duration": 678,
      "view_count": 94,
      "like_count": 5,
      "dislike_count": 2,
      "comment_count": 3,
      "game_id": 1,
      "image": "https:\/\/cdn.yogsdb.com\/LTSTv5cH-dE.jpg",
      "channel": {
        "id": 4,
        "youtube_id": "UCfBK-LZUQX3sFs3E-hb_6IQ",
        "title": "Tap! Best iOS and Android Games",
        "description": "Tap! Love Mobile Games? Like doing something on your phone that isn't endlessly refreshing your Twitter feed for more cat gifs? \n\nWhether you're a member of the Cult of Apple, or an Android Fanatic (let's face it nobody has a Window's phone), then Tap! is the place for you!\n\nFeaturing the latest mobile games, feature videos, let's plays, and more! We're the tip tip channel for great mobile gaming on YouTube! So get TAPing!",
        "created_at": "2017-03-11 20:13:17",
        "updated_at": "2017-07-09 17:34:28",
        "slug": "tap-best-ios-and-android-games",
        "view_count": 2448810,
        "comment_count": 0,
        "subscriber_count": 35873,
        "video_count": 205,
        "image": "https:\/\/cdn.yogsdb.com\/channel\/UCfBK-LZUQX3sFs3E-hb_6IQ.jpg"
      },
      "game": {
        "id": 1,
        "created_at": "2017-03-12 15:23:02",
        "updated_at": "2017-03-12 15:25:15",
        "title": "Unknown",
        "description": "",
        "thumbnail": "",
        "slug": "unknown",
        "aliases": null
      },
      "stars": [
 
      ]
    }
  ],
  "from": 1,
  "last_page": 32179,
  "next_page_url": "https:\/\/api.yogsdb.com\/api\/videos?page=2",
  "path": "https:\/\/api.yogsdb.com\/api\/videos",
  "per_page": 1,
  "prev_page_url": null,
  "to": 1,
  "total": 32179
}

Specific

 Request
https://api.yogsdb.com/api/videos/{id}

Return value

{
  "id": 14273,
  "youtube_id": "fUoESIpV_T0",
  "title": "GTA BINGO | GTA 5 Online",
  "description": "It's GTA 5 online! In GTA today, we're playing GTA bingo. Why not play along at home?\n|| GTA Playlist https:\/\/www.youtube.com\/watch?v=N-3mbffmdQA&list=PL3XZNMGhpynOuAanuf80lmuwj5QzPmc54&t=25s&index=1\n|| Featuring\nDuncan https:\/\/www.youtube.com\/user\/Yogscastlalna\/featured\nRythian https:\/\/www.youtube.com\/user\/YogscastRythian\/featured\nTom https:\/\/www.youtube.com\/channel\/UC5rUMdCFWPXYs9e8PBLzq5g\/featured\nBen https:\/\/twitter.com\/Bedgarsan\n\n|| Get your Yogscast merch here \u25ba http:\/\/smarturl.it\/yogsSimonAndLewis \u25c4\n\n\u2665 Don't forget to subscribe: http:\/\/yogsca.st\/SUBSCRIBE \u2665\n\u2665 And you can watch us live on Twitch.tv every night!  http:\/\/www.twitch.tv\/yogscast\/ \u2665\n\nCheck out our popular series here! \nMinecraft Kingdoms: https:\/\/www.youtube.com\/watch?v=KFVFp7fDvn0&index=1&list=PL3XZNMGhpynP-HQ_WhgxUUJYww4tdQqRW\n\nTuesdays with Simon: https:\/\/www.youtube.com\/watch?v=TgK20czfqUk&index=1&list=PL3XZNMGhpynNuLYTwxKnZzKMTtj1Rpo4C\n\nOneShot: https:\/\/www.youtube.com\/watch?v=jhUOuXDuvLU&list=PL3XZNMGhpynO4zNTbWTXMuN4NuX99mp7s&index=2\n\nGTA: https:\/\/www.youtube.com\/watch?v=gtM-h5Yem2Q&index=1&list=PL3XZNMGhpynOuAanuf80lmuwj5QzPmc54\n\nTTT and Gmod: https:\/\/www.youtube.com\/watch?v=HVIl4FtyHsI&list=PL3XZNMGhpynMp4Q9oiLhffheHJtYhP2bp&index=1\n\nGames Night: https:\/\/www.youtube.com\/watch?v=c4W_GGDr6Kc&list=PL3XZNMGhpynP64vJKFjlLWI7SJql1TBBA&index=1\n\nProduction music courtesy of Epidemic Sound \n\nPowered by Doghouse Systems in the US:\nhttp:\/\/www.doghousesystems.com\/v\/yogscast.asp\nUse the code YOGSCAST to get a free 240GB SSD and a groovy Honeydew graphic applied to any case!\nPowered by Chillblast in the UK: http:\/\/www.chillblast.com\/yogscast.html\n\nMailbox: The Yogscast, PO Box 3125 Bristol BS2 2DG\nBusiness enquiries: [email protected]",
  "created_at": "2017-07-08 17:10:03",
  "updated_at": "2017-07-09 13:30:15",
  "channel_id": 1,
  "slug": "gta-bingo-gta-5-online",
  "upload_date": "2017-07-08 17:00:04",
  "duration": 1195,
  "view_count": 143526,
  "like_count": 5324,
  "dislike_count": 74,
  "comment_count": 570,
  "game_id": 44,
  "image": "https:\/\/cdn.yogsdb.com\/fUoESIpV_T0.jpg",
  "channel": {
    "id": 1,
    "youtube_id": "UCH-_hzb2ILSCo9ftVSnrCIQ",
    "title": "YOGSCAST Lewis & Simon",
    "description": "Minecraft and multiplayer comedy gaming with a drunken dwarf and a handsome spaceman! Join us as we laugh our way through the best, the worst and the funniest indie games, Minecraft mods, mini-games and adventure maps.\n\nYogscast official merchandise store: http:\/\/store.yogscast.com\/\nYogscast Games Store: http:\/\/games.yogscast.com\nTwitch Channel: http:\/\/twitch.tv\/yogscast\nYogscast Official Computers: http:\/\/www.chillblast.com\/yogscast\/",
    "created_at": "2017-03-11 18:59:12",
    "updated_at": "2017-07-09 17:34:28",
    "slug": "yogscast-lewis-simon",
    "view_count": 3610201471,
    "comment_count": 141287,
    "subscriber_count": 7325606,
    "video_count": 4010,
    "image": "https:\/\/cdn.yogsdb.com\/channel\/UCH-_hzb2ILSCo9ftVSnrCIQ.jpg"
  },
  "game": {
    "id": 44,
    "created_at": "2017-03-16 20:46:57",
    "updated_at": "2017-03-16 20:46:57",
    "title": "Grand Theft Auto V",
    "description": "",
    "thumbnail": "",
    "slug": "grand-theft-auto-v",
    "aliases": null
  },
  "stars": [
    {
      "id": 2,
      "youtube_id": "UCH-_hzb2ILSCo9ftVSnrCIQ",
      "title": "Lewis",
      "description": "Lewis \"Xephos\" Brindley",
      "created_at": "2017-03-12 01:05:41",
      "updated_at": "2017-03-12 01:05:41",
      "pivot": {
        "video_id": 14273,
        "star_id": 2
      }
    },
    {
      "id": 4,
      "youtube_id": "UC5rUMdCFWPXYs9e8PBLzq5g",
      "title": "Tom",
      "description": "",
      "created_at": "2017-03-12 01:07:35",
      "updated_at": "2017-03-16 22:41:07",
      "pivot": {
        "video_id": 14273,
        "star_id": 4
      }
    },
    {
      "id": 5,
      "youtube_id": "UCs4br3aZLU0sOEM-3n0-6xQ",
      "title": "Duncan",
      "description": "",
      "created_at": "2017-03-12 01:08:34",
      "updated_at": "2017-03-12 01:08:34",
      "pivot": {
        "video_id": 14273,
        "star_id": 5
      }
    },
    {
      "id": 12,
      "youtube_id": "UCQd82ZrlW8b8_MujwDO9ajw",
      "title": "Rythian",
      "description": "",
      "created_at": "2017-03-12 01:11:06",
      "updated_at": "2017-03-12 01:11:06",
      "pivot": {
        "video_id": 14273,
        "star_id": 12
      }
    },
    {
      "id": 24,
      "youtube_id": "",
      "title": "Ben",
      "description": "",
      "created_at": "2017-03-16 22:40:38",
      "updated_at": "2017-03-16 22:40:38",
      "pivot": {
        "video_id": 14273,
        "star_id": 24
      }
    }
  ]
}

Stars

Note: Where stars return a channel, that is the Star’s primary channel

All

Request

https://api.yogsdb.com/api/stars

Return value

{
  "current_page": 1,
  "data": [
    {
      "id": 1,
      "youtube_id": "UCH-_hzb2ILSCo9ftVSnrCIQ",
      "title": "Simon",
      "description": "Simon \"Honeydew\" Lane",
      "created_at": "2017-03-12 01:05:05",
      "updated_at": "2017-03-12 01:05:05",
      "channel": {
        "id": 1,
        "youtube_id": "UCH-_hzb2ILSCo9ftVSnrCIQ",
        "title": "YOGSCAST Lewis & Simon",
        "description": "Minecraft and multiplayer comedy gaming with a drunken dwarf and a handsome spaceman! Join us as we laugh our way through the best, the worst and the funniest indie games, Minecraft mods, mini-games and adventure maps.\n\nYogscast official merchandise store: http:\/\/store.yogscast.com\/\nYogscast Games Store: http:\/\/games.yogscast.com\nTwitch Channel: http:\/\/twitch.tv\/yogscast\nYogscast Official Computers: http:\/\/www.chillblast.com\/yogscast\/",
        "created_at": "2017-03-11 18:59:12",
        "updated_at": "2017-07-09 17:34:28",
        "slug": "yogscast-lewis-simon",
        "view_count": 3610201471,
        "comment_count": 141287,
        "subscriber_count": 7325606,
        "video_count": 4010,
        "image": "https:\/\/cdn.yogsdb.com\/channel\/UCH-_hzb2ILSCo9ftVSnrCIQ.jpg"
      }
    }
  ],
  "from": 1,
  "last_page": 25,
  "next_page_url": "https:\/\/api.yogsdb.com\/api\/stars?page=2",
  "path": "https:\/\/api.yogsdb.com\/api\/stars",
  "per_page": 1,
  "prev_page_url": null,
  "to": 1,
  "total": 25
}

Specific

Request

https://api.yogsdb.com/api/stars/{id}

Return value

{
  "id": 1,
  "youtube_id": "UCH-_hzb2ILSCo9ftVSnrCIQ",
  "title": "Simon",
  "description": "Simon \"Honeydew\" Lane",
  "created_at": "2017-03-12 01:05:05",
  "updated_at": "2017-03-12 01:05:05",
  "channel": {
    "id": 1,
    "youtube_id": "UCH-_hzb2ILSCo9ftVSnrCIQ",
    "title": "YOGSCAST Lewis & Simon",
    "description": "Minecraft and multiplayer comedy gaming with a drunken dwarf and a handsome spaceman! Join us as we laugh our way through the best, the worst and the funniest indie games, Minecraft mods, mini-games and adventure maps.\n\nYogscast official merchandise store: http:\/\/store.yogscast.com\/\nYogscast Games Store: http:\/\/games.yogscast.com\nTwitch Channel: http:\/\/twitch.tv\/yogscast\nYogscast Official Computers: http:\/\/www.chillblast.com\/yogscast\/",
    "created_at": "2017-03-11 18:59:12",
    "updated_at": "2017-07-09 17:34:28",
    "slug": "yogscast-lewis-simon",
    "view_count": 3610201471,
    "comment_count": 141287,
    "subscriber_count": 7325606,
    "video_count": 4010,
    "image": "https:\/\/cdn.yogsdb.com\/channel\/UCH-_hzb2ILSCo9ftVSnrCIQ.jpg"
  }
}

Games

All

Request

https://api.yogsdb.com/api/games

Return value

{
  "current_page": 1,
  "data": [
    {
      "id": 1,
      "created_at": "2017-03-12 15:23:02",
      "updated_at": "2017-03-12 15:25:15",
      "title": "Unknown",
      "description": "",
      "thumbnail": "",
      "slug": "unknown",
      "aliases": null
    }
  ],
  "from": 1,
  "last_page": 992,
  "next_page_url": "https:\/\/api.yogsdb.com\/api\/games?page=2",
  "path": "https:\/\/api.yogsdb.com\/api\/games",
  "per_page": 1,
  "prev_page_url": null,
  "to": 1,
  "total": 992
}

Specific

Request

https://api.yogsdb.com/api/games/{id}

Return value

{
  "id": 44,
  "created_at": "2017-03-16 20:46:57",
  "updated_at": "2017-03-16 20:46:57",
  "title": "Grand Theft Auto V",
  "description": "",
  "thumbnail": "",
  "slug": "grand-theft-auto-v",
  "aliases": null
}

Series

Note: Not yet implemented

Trivias

Note: Not yet implemented

I realise this should probably be “Trivium” or something if we really wanted to properly pluralise it, but it’s not

Quotes

Note: Not yet implemented