Skip to content
Bazoodle API

Browse games

GET /catalog/browse returns a page of games, optionally from one category or with a filter, in the order you choose. It is the main way to list games, and its response introduces the game card used by every list.

Request

Section titled “Request”
Terminal window
curl -s "https://bazoodle.com/api/v1/catalog/browse?tag=party&sort=new&limit=10"
Parameter Meaning Allowed values Default
tag Only games with this tag An id from Categories all games
filter Narrow by number of players two_players (games two people can play) or solo (games for one player) none
sort Order of the list popular, new or top popular
limit Page size 1 to 50 24
offset Games to skip 0 to 500 0

limit and offset work as described in Paging through lists. tag, filter and sort can be combined: “solo puzzle games, best rated first” is tag=puzzle&filter=solo&sort=top.

The three orders

Section titled “The three orders”
  • popular: the games most players played today and yesterday first, then the most liked.
  • new: the games that went public most recently first.
  • top: the best rated first. It is the share of thumbs-up among all votes, adjusted so that a game with one lucky vote does not beat a game thousands of players liked.

Response

Section titled “Response”
{
  "games": [
    {
      "id": "coins",
      "title": "Coin Grab",
      "creator": {"id": "BZSAMPLES00001", "name": "Bazoodle Samples"},
      "tags": ["party"],
      "tier": "kid",
      "players": {"min": 1, "max": 8},
      "like_pct": null,
      "players_online": 0,
      "thumbnail": null,
      "thumbnail_url": null
    }
  ],
  "next_offset": 1
}
Field Type Meaning
games list of game cards The page of games. It can be empty.
next_offset number or null Where the next page starts, or null on the last page.

The game card

Section titled “The game card”

A game card is the short description of a game used in every list: home rows, browse, search and the similar list of a game page. It has everything you need to draw a tile and link to the game.

Field Type Meaning
id string The game’s identifier. The page for people is https://bazoodle.com/game/<id>; the full record is GET /catalog/games/<id>.
title string The game’s name, written by its creator. Plain text.
creator object {id, name}: a public player id and a made-up username. See Kid safety.
tags list of strings The game’s category ids. At most three; can be empty.
tier string kid, teen or mature. Always kid for public calls.
players object {min, max}: the fewest and most players in one session. min 1 and max 1 is a single-player game.
like_pct number or null The share of thumbs-up among all votes as a whole percentage. null until the game has at least five votes, so one vote cannot make a game look perfect or terrible.
players_online number How many players are in a session of this game that has recent activity. 0 when nobody is.
thumbnail string or null The internal file key of the thumbnail. Do not use it; use thumbnail_url.
thumbnail_url string or null The full address of the thumbnail picture, or null when the game has none. See Media files.
  • Do not assume thumbnail_url is present: draw a placeholder when it is null.
  • The same game can appear in several lists; its id identifies it.

Errors

Section titled “Errors”
Status error Cause
400 unknown tag tag is not one of the ids in Categories
400 unknown filter filter is not two_players or solo
400 sort must be popular, new or top sort has another value

Notes

Section titled “Notes”