Watch2Gether API Documentation

How to use Watch2Gether
124

Hello there,
First, thanks for the service provided, that’s amazing.
I’m a web developer that want to make a little addon with status of room and additionnal features for our private discord server with my firends.

I just wanna ask if there is possibility to fetch the status of a room with the api , like a GET call ?

Basically i need the same data as the “/playlist_items” call, but can be fetched from anyone with the api_key.

Let me know if this is possible or not :slight_smile:
Have a good day .

125

Thanks for your request and sorry for my late reply. I’m not sure if I understand what kind of status information you would like to fetch. Can you explain a bit more in detail?

126

Hi, ive made a discord bot that works well with this api, so thank you for making it! :slight_smile:
I was just wondering if it is possible to get current active users in the room from the api? If not, would be a nice feature to add i think!
Thank you!

127

Hi,
first of all thank you for creating Watch2Gether and the api.

I am currently working on a watchlist manager, so a few friends of mine and me can keep track of what we want to watch together. As we use W2G to do the watching I’d love to integrate W2G as seamlessly as possible into this watchlist manager.

For this integration I’d like to know what the status is on features mentioned previously in this thread:

  • list rooms available in my account
  • list videos in current playlist
  • choosing which playlist to add videos to/interact with

Also I’d like to append my own personal wishlist to this:

  • It would be pretty neat to be able to get the current status of a room
    for example responding with something like this:
{
    "status": *some kind of data indicating what the player is currenty doing, e.g.: **"playing" | "paused"***,
    "playlists": *array of available playlists*, 
    "current_playlist": {
        "key": *key of the current playlist*,
        "entries": *array containing the current playlist's entries*
    },
    "timestamp": *the timestamp of the video currently playing*,
    "current_entry": {
        "title": *title of the video currently playing*
        "url": *url of the video currentl playing*
    },
    "users": *list of users in the room*
}
  • I’d love to have a way to get a status update on switching videos and/or changing playback status, so an app using the api can also display what is currently going on without spamming a potential status endpoint
  • update the playback status (remotely press play/pause) and the playhead position (jump to minute 12:32 in the video) via the api

I know this is kind of a big list, but getting even some of those features would make the api of even greater use imo.

Thanks for any answers in advance!

128

is there anyway to add subtitle files along whit the direct video url when using the API? or is that maybe a limitation on the video player as a whole?

129

Thanks for getting in touch. This is something that would have to be implemented in the player. Not impossible but a little bit of work. Do you think of a scenario where you would add the subtitle file for all users watching in the room? In this case the file needs to be hosted somewhere so that it’s available for all users.

130

I’m currently writing a Discord Bot that recognises YouTube links in a channel and then adds them directly to the playlist. This works quite well so far.

I use the YouTube API to query the details of the video and pass them to the bot. I can pass on the title, but there is no parameter for the thumbnail in the API.

Is it possible to include thumbnails?

Cheers.

131

Thanks for getting in touch. Yes that is possible. Simply include the property “thumb” in the item object your are posting and set it to a fully qualified URL to a thumbnail. Does that help?

1 Like