Developers
Everything below is a static file regenerated on every release: no key, no sign-up and no request limit beyond fair use. Responses are UTF-8 JSON or CSV and can be fetched from any origin. Please cache them; they change only when we publish.
Endpoints
| Address | Contents |
|---|---|
/api/games.json | Every game: slug, title, description, category, page and play addresses, version, players, tags. |
/api/returns.json | Return to player and house edge of every casino-style bet, grouped by game. |
/data/returns.csv | The same returns as a CSV table, one row per bet. |
/api/articles.json | Every guide and article: title, address, description, dates, category. |
/rss.xml | Feed of new articles. |
/sitemap.xml | Every page on the site. |
/llms.txt | Plain-text orientation for AI systems. |
/.well-known/api-catalog | Machine-readable list of these endpoints (RFC 9727). |
A game in /api/games.json looks like this:
{
"slug": "klondike",
"title": "Klondike Solitaire",
"category": "Card Games",
"url": "https://dicegem.com/games/klondike/",
"play_url": "https://play.dicegem.com/klondike/1.0.0/",
"version": "1.0.0",
"players": {
"min": 1,
"max": 1
}
}
The slug is stable and safe to store. The play_url points to a specific version of
the game; when we release a new version, its address changes and the catalogue is updated. Field meanings for
the returns data are documented on the open data page.
License
The catalogue and returns data are licensed under CC BY 4.0: credit DiceGem with a link. Article text, game names, artwork and game code are not covered by this license and may not be republished without permission.
Embedding games
Games run from a separate address (play.dicegem.com) so they can be framed on other
sites. Embedding is free and needs no sign-up: every game page has the code, and WordPress sites can use our
plugin (see embedding our games). The minimal form is:
<iframe
src="https://play.dicegem.com/klondike/1.0.0/"
title="Klondike Solitaire"
width="960" height="600"
allow="fullscreen"
loading="lazy"></iframe>- Take
play_urlfrom/api/games.jsonrather than building it by hand, so you always embed the current version. Older versions stay online. ?pub=YOUR_PUBLISHER_IDis optional and only for members of the publisher programme (letters, digits,-and_); it attributes plays to your site.- Games report anonymous play events (load, start, end) together with the publisher ID, if any, and the address of the embedding site. See our privacy policy.
To join the publisher programme, write to [email protected] with your site's address. Embedded games are covered by our terms.