# Games

Every public game under the studio with its counts, votes and play link, most played first.

`GET https://api.dietbloxycola.com/v1/games` (cached 300 s)

## Request

cURL:

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

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

```python
import requests

list = requests.get("https://api.dietbloxycola.com/v1/games", 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/games")
local list = HttpService:JSONDecode(body)
```

## Response fields

`games` is an array of game objects, each with the fields below. The full dictionary is on the [fields](https://api.dietbloxycola.com/docs/fields) page.

| Field | Type | Meaning |
| --- | --- | --- |
| universeId | integer | The Roblox universe id. The id this API keys on. |
| placeId | integer | The start place, where the play link goes. |
| name | string | The game's name as Roblox lists it. |
| genre | string | The studio's own one-line label, not Roblox's genre field. |
| playing | integer | Players online across every server, Roblox's count. |
| visits | integer | Lifetime visits, Roblox's count. |
| favorites | integer | Favorites, Roblox's count. |
| upVotes | integer | Thumbs up, Roblox's count. |
| downVotes | integer | Thumbs down, Roblox's count. |
| playUrl | string | The game's page on roblox.com. |

## Sample

200 OK:

```json
{
  "games": [
    {
      "universeId": 10761832456,
      "placeId": 111915625434802,
      "name": "Shoplifters",
      "genre": "Social deduction",
      "playing": 12,
      "visits": 51234,
      "favorites": 861,
      "upVotes": 190,
      "downVotes": 14,
      "playUrl": "https://www.roblox.com/games/111915625434802"
    }
  ]
}
```

## Notes

- The list refreshes about every 5 minutes and the CDN window matches it.
- Answers 503 instead of placeholder zeros when Roblox cannot be read: an empty shelf is furniture, not data.
- Ordered by players online, then by name.