List Live and Pre-made Streams API

This API endpoint returns a list of rooms with status SOON or LIVE, created via the Room API or the admin panel. It provides details on each stream's current status, configuration, and metadata.

Results are sorted by startTime in ascending order (earliest first).

Endpoint URL

⚠️
Regional endpoints: Replace chatbackend.watchers.io with the endpoint matching your project region. See Supported Regions for details.

Region Endpoint

Europe (default) chatbackend.watchers.io

North America chatbackend.us.watchers.io

South America chatbackend.sa.watchers.io

Asia chatbackend.hk.watchers.io

Africa chatbackend.za.watchers.io

Region	Endpoint
Europe (default)	`chatbackend.watchers.io`
North America	`chatbackend.us.watchers.io`
South America	`chatbackend.sa.watchers.io`
Asia	`chatbackend.hk.watchers.io`
Africa	`chatbackend.za.watchers.io`

https://chatbackend.watchers.io/room/premade?apiKey={API KEY}

Authentication

Parameter	In	Required	Description
`apiKey`	query	Yes	API key of your project from the admin panel.

Response Structure

The API returns a JSON array of room objects. Each object contains the following fields:

Field	Type	Description
`id`	number	Internal room ID.
`externalRoomId`	string	Unique room ID provided at creation.
`status`	string	Room status: `LIVE` or `SOON`.
`name`	string \| null	Room name.
`about`	string \| null	Room description.
`isSpeak`	boolean	Whether voice chat is enabled.
`autoRecord`	boolean	Whether auto-recording is enabled.
`pic`	string \| null	Room picture URL (original).
`pic96`	string \| null	Room picture URL (96x96).
`pic128`	string \| null	Room picture URL (128x128).
`pic800`	string \| null	Room picture URL (800x800).
`startTime`	string \| null	Planned room start time (ISO 8601 UTC).
`endTime`	string \| null	Planned room end time (ISO 8601 UTC).
`createdAt`	string	Room creation timestamp (ISO 8601 UTC).
`isSlowmode`	boolean	Whether slow mode is active.
`slowmodeDelayMS`	number	Delay between messages in slow mode (milliseconds).
`record`	string \| null	URL of the room recording, if available.
`streamUrl`	string \| null	External livestream URL.
`sourceUrl`	string \| null	Original stream source URL.
`embedUrl`	string \| null	Auto-generated embed URL (from `sourceUrl`). Supports YouTube, Twitch, Kick, Facebook, Vimeo.
`streamStartTime`	string \| null	Planned stream start time (ISO 8601 UTC).
`streamEndTime`	string \| null	Planned stream end time (ISO 8601 UTC).
`videoPosition`	string \| null	Video player position in the room layout (`OVER`, `UNDER`, or `null`).
`eventDate`	string \| null	Event date associated with the room.
`eventTitle`	string \| null	Event title associated with the room.
`talkersCount`	number	Number of users who joined the room.
`messagesCount`	number	Total number of messages in the room.

The response may also contain additional internal fields not listed here. These are not part of the public API contract and should not be relied upon.

Example

Shell

curl -s 'https://chatbackend.watchers.io/room/premade?apiKey=YOUR_API_KEY'

Response:

JSON

[
  {
    "id": 1,
    "externalRoomId": "liveevent123",
    "status": "LIVE",
    "name": "Live Conference",
    "about": "Annual keynote",
    "isSpeak": true,
    "autoRecord": false,
    "pic": "https://cdn.example.com/room.jpeg",
    "pic96": "https://cdn.example.com/room-96.jpeg",
    "pic128": "https://cdn.example.com/room-128.jpeg",
    "pic800": "https://cdn.example.com/room-800.jpeg",
    "startTime": "2025-08-14T09:00:00.000Z",
    "endTime": "2025-08-14T10:00:00.000Z",
    "createdAt": "2025-08-13T12:00:00.000Z",
    "isSlowmode": false,
    "slowmodeDelayMS": 0,
    "record": null,
    "streamUrl": null,
    "sourceUrl": "https://www.youtube.com/watch?v=example",
    "embedUrl": "https://www.youtube.com/embed/example",
    "streamStartTime": null,
    "streamEndTime": null,
    "videoPosition": "OVER",
    "eventDate": null,
    "eventTitle": null,
    "talkersCount": 670,
    "messagesCount": 421
  }
]

Updated 5 months ago