# Scenes

Scene discovery and popularity endpoints

## Get hot scenes across all realms

> 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.<br>

```json
{"openapi":"3.1.0","info":{"title":"Realm Provider API","version":"1.0.0"},"tags":[{"name":"Scenes","description":"Scene discovery and popularity endpoints"}],"servers":[{"url":"https://realm-provider.decentraland.org","description":"Production server"}],"security":[],"paths":{"/hot-scenes":{"get":{"summary":"Get hot scenes across all realms","description":"Returns up to 100 scenes sorted by total user count across all realms.\nEach scene includes its ID, name, coordinates, parcels, user count, and realm distribution.\n","operationId":"getHotScenes","tags":["Scenes"],"responses":{"200":{"description":"Successful response with list of hot scenes","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","description":"Information about a popular scene across all realms","required":["id","baseCoords","parcels","usersTotalCount","realms"],"properties":{"id":{"type":"string","description":"Unique scene identifier"},"name":{"type":"string","description":"Display name of the scene (may be absent when scene metadata lacks a display title)"},"baseCoords":{"type":"array","description":"Base coordinates of the scene [x, y]","items":{"type":"number"},"minItems":2,"maxItems":2},"parcels":{"type":"array","description":"Array of parcel coordinates that make up the scene","items":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2}},"usersTotalCount":{"type":"number","description":"Total number of users across all realms in this scene"},"realms":{"type":"array","description":"Distribution of users across realms for this scene","items":{"type":"object","description":"User count for a scene in a specific realm","required":["serverName","usersCount"],"properties":{"serverName":{"type":"string","description":"Name of the realm server"},"usersCount":{"type":"number","description":"Number of users in this scene on this realm"}}}},"thumbnail":{"type":"string","format":"uri","description":"Optional thumbnail URL for the scene"}}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"integer","description":"Error code"}},"required":["error"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"integer","description":"Error code"}},"required":["error"]}}}}}}}}}
```