Game detail

GET /catalog/games/:id returns everything on a game’s page: the full description, how to play, the creator, tags, the five latest updates, up to six similar games and the addresses of its pictures.

Request

curl -s "https://bazoodle.com/api/v1/catalog/games/coins"

:id is the game’s id from any game card: a short lower-case code such as coins or 783f6ff765c7.

Response

{
  "id": "coins",
  "title": "Coin Grab",
  "description": "Race other players to grab the coins. Most coins when the round ends wins.",
  "controls_text": "",
  "creator": {"id": "BZSAMPLES00001", "name": "Bazoodle Samples", "games": 3},
  "tags": ["party"],
  "tier": "kid",
  "rating_label": "Kid-friendly",
  "players": {"min": 1, "max": 8},
  "like_pct": null,
  "players_online": 0,
  "version": "1",
  "updated_at": 1792290579,
  "updates": [{"version": "1", "at": 1792290579, "notes": "Sample game"}],
  "remix_allowed": false,
  "remix_of": null,
  "thumbnail": null,
  "thumbnail_url": null,
  "gallery": [],
  "similar": [ ...up to 6 game cards... ],
  "viewer": {"signed_in": false}
}

It has all the fields of a game card (id, title, tags, tier, players, like_pct, players_online, thumbnail, thumbnail_url) and these:

Field	Type	Meaning
`description`	string	The long description, written by the creator and checked by moderation. Paragraphs are separated by blank lines. Plain text.
`controls_text`	string	The “How to play” text: which keys or buttons do what. Empty when the creator has not written one.
`creator`	object	As on a card, plus `games`: how many public games the creator has.
`rating_label`	string	The tier in words: `Kid-friendly`, `Teen` or `Mature`.
`version`	string	The version of the game that is live.
`updated_at`	number	When that version went live, in Unix seconds.
`updates`	list	The five latest versions, newest first; see below.
`remix_allowed`	boolean	Whether other creators may make their own copy of the game.
`remix_of`	object or `null`	`null` unless the game is a remix. Then it is `{id, title, creator}` of the original; if the original is gone, `id` and `creator` are `null` and only `title` is set.
`gallery`	list of strings	Addresses of the game’s screenshots, in the order the creator chose. Can be empty.
`similar`	list of game cards	Up to six well-rated games that share a tag with this one. A stated rule, not personalisation.
`viewer`	object	Always `{"signed_in": false}` for public calls.

An update

Field	Type	Meaning
`version`	string	The version name that went live.
`at`	number	When it went live, in Unix seconds. In JavaScript use `new Date(update.at * 1000)`.
`notes`	string	The creator’s note about the change. Plain text; can be short or empty.

Errors

Status	`error`	Cause
`404`	`not found`	No such game, or it is not public, was taken down, or is above the kid-friendly level

Notes

Show description, controls_text and update notes as plain text; they were written by creators, so escape them for the web.
Everything in thumbnail_url and gallery is a ready-to-use address: see Media files.
The page for people is https://bazoodle.com/game/<id>. Link there so players can play the game.
Cached for 15 seconds. A guide is in Show a game page.