Bazoodle public API

The Bazoodle public API lets your own tools read what is public on Bazoodle: browse and search games, read a game’s page, fetch its pictures and check whether the service is running. It is the same read-only API the Bazoodle website uses to draw its own pages.

• Free. No key and no sign-up.
• Read-only. You cannot change anything on Bazoodle with it.
• Kid-safe by design. Without a signed-in account every list and every game is filtered to kid-friendly games. Responses carry no email addresses, birthdays or other private details, and the only names in them are the made-up usernames players already show on their game pages.

Your first request

curl

curl -s "https://bazoodle.com/api/v1/catalog/browse?sort=new&limit=2"

JavaScript

const response = await fetch("https://bazoodle.com/api/v1/catalog/browse?sort=new&limit=2");
const { games, next_offset } = await response.json();
console.log(games.map((game) => game.title), next_offset);

Python

import json
import urllib.request

request = urllib.request.Request(
    "https://bazoodle.com/api/v1/catalog/browse?sort=new&limit=2",
    headers={"User-Agent": "MyGameList/1.0 (contact: you@example.com)"},
)
with urllib.request.urlopen(request) as response:
    page = json.load(response)
print([game["title"] for game in page["games"]], page["next_offset"])

You get JSON back: a list of games and a next_offset for the next page. See Browse games.

Where to go next

Making requestsBase URL, responses, errors, paging and browsers.

Limits and cachingHow often you may call, and how long answers stay fresh.

Kid safetyWhy you only see kid-friendly games and what is never included.

Fair useThe simple rules for using the API, and what may change.

ReferenceEvery endpoint with its parameters and every response field.

GuidesWorking examples in curl, JavaScript and Python.

What is not in these docs

Accounts, publishing, creator tools, friends, moderation, payments and live game sessions are not part of the public API. They need a signed-in player and are not documented or open to outside tools. If you have a use for something that is not here, write to help@bazoodle.com.