---
title: "Get hot scenes across all realms"
method: GET
path: "/hot-scenes"
tags: ["Scenes"]
---

# Get hot scenes across all realms

`GET /hot-scenes`

Returns up to 100 scenes sorted by total user count across all realms.
Each scene includes its ID, name, coordinates, parcels, user count, and realm distribution.

## Response `200`

Successful response with list of hot scenes

- object[]
  - `id` string, required — Unique scene identifier
  - `name` string — Display name of the scene (may be absent when scene metadata lacks a display title)
  - `baseCoords` number[], required — Base coordinates of the scene [x, y]
  - `parcels` array[], required — Array of parcel coordinates that make up the scene
    - number[]
  - `usersTotalCount` number, required — Total number of users across all realms in this scene
  - `realms` object[], required — Distribution of users across realms for this scene
    - `serverName` string, required — Name of the realm server
    - `usersCount` number, required — Number of users in this scene on this realm
  - `thumbnail` string, uri — Optional thumbnail URL for the scene

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)