# Live numbers

Players online, visits and favorites across the studio, and the same per game, refreshed every few seconds.

`GET https://api.dietbloxycola.com/v1/live` (cached 5 s)

## Request

cURL:

```bash
curl https://api.dietbloxycola.com/v1/live
```
JavaScript:

```js
const res = await fetch("https://api.dietbloxycola.com/v1/live");
const live = await res.json();
```
Python:

```python
import requests

live = requests.get("https://api.dietbloxycola.com/v1/live", timeout=10).json()
```
Luau:

```lua
-- HttpService must be on in the game's settings.
local HttpService = game:GetService("HttpService")

local body = HttpService:GetAsync("https://api.dietbloxycola.com/v1/live")
local live = HttpService:JSONDecode(body)
```

## Response fields

| Field | Type | Meaning |
| --- | --- | --- |
| playing | integer | Players online across every public game, right now. |
| visits | integer | Lifetime visits summed across the games. |
| favorites | integer | Favorites summed across the games. |
| games | array | One entry per public game: universeId, playing, visits, favorites, upVotes, downVotes. |

## Sample

200 OK:

```json
{
  "playing": 12,
  "visits": 51234,
  "favorites": 861,
  "games": [
    {
      "universeId": 10761832456,
      "playing": 12,
      "visits": 51234,
      "favorites": 861,
      "upVotes": 190,
      "downVotes": 14
    }
  ]
}
```

## Notes

- Held by the CDN for 5 seconds; polling faster reads the cache.
- Answers 503 with `{ "error": "unavailable" }` when Roblox cannot be read.
- The counts are Roblox's, not the studio's own telemetry.