Watch2Gether API Documentation

Watch2Gether provides a simple API that allows you to problematically create new rooms and set an initial video for those rooms.

If you don’t have a Watch2Gether account yet, sign up here first: https://w2g.tv/auth/sign_up

The required API key can be generated in you account settings.
Login to your account > “Edit Profile” on the right > At the bottom “New” to generate a new key

All rooms that you create using the key will be owned by the account associated with the key.

You can create a new room by sending a POST request to:

https://w2g.tv/rooms/create.json

You can include these parameters in the JSON formatted body of your request:

{ 
    "w2g_api_key" : "<your api key>",
    "share" : "https://www.youtube.com/watch?v=tpiyEe_CqB4",  // URL of the video to share - optional
    "bg_color" : "#00ff00", // Background color of the room in HTML notation - optional
    "bg_opacity" : "50" // Background opacity of the room (0 - 100) - optional
}

In return you get a JSON string. The value of “streamkey” can be used to build the URL of the new Watch2Gether room: https://w2g.tv/rooms/{streamkey}

When you open that room, the shared video will be preloaded.

Hey is it possible to add the feature to set the room color and gradient to this api as an optional field?

Cool idea… yes that should be possible quite easily. Will have a look later.

And i have an second idea: Because the api key is now linked with my account is it possible to link the username and/or profile picture also? (So in the channel members its not a “User-randomstring”) Or to hide the creator if its created via API?

You can now set the background color and opacity in the API call.

1 Like