Home

GET /catalog/home returns what the Bazoodle home page shows: a featured carousel and rows of games, such as “Popular now” and “New this week”. Use it when you want a ready-made front page instead of building one from browse calls.

Request

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

Parameter	Meaning
`cats`	Optional. A comma-separated list of category ids to turn into category rows, for example `cats=obby,puzzle`. Unknown ids are ignored. At most three are used. Without `cats` the rows for `party` and `obby` are returned.

Response

{
  "tier": "kid",
  "featured": [],
  "for_you": {"available": false, "shown": false},
  "rows": [
    {"id": "popular", "title": "Popular now", "games": [ ...game cards... ]},
    {"id": "new", "title": "New this week", "games": [ ...game cards... ]},
    {"id": "category:party", "title": "Party games", "games": [ ...game cards... ]}
  ]
}

Field	Type	Meaning
`tier`	string	The highest tier the response was filtered to. For public calls this is `kid`.
`featured`	list of game cards	Games chosen by Bazoodle’s staff for the carousel, up to 8. It can be empty.
`for_you`	object	Always `{"available": false, "shown": false}` for public calls: the “For you” row exists only for signed-in players and is built from their own play history.
`rows`	list of rows	In order: `popular`, `new`, then one `category:<id>` row for each requested category.

The game cards are described in Browse.

A row

Field	Type	Meaning
`id`	string	A stable code: `popular`, `new`, or `category:<id>` where `<id>` is a category. Use it in code.
`title`	string	The heading for people: “Popular now”, “New this week”, “Party games”. It may be reworded.
`games`	list of game cards	The games on the shelf, up to 12. A row with no games is still listed, with an empty `games` list.

popular is ordered by how many players played over today and yesterday, then by likes. new is the games that went public most recently. category:<id> is the same list as /catalog/browse?tag=<id>, limited to 12 games.
Cached for 15 seconds (Cache-Control: private, max-age=15); see Limits and caching.
For a long list or a particular order, use Browse.