Add a daily number puzzle to your game or app
A daily puzzle brings players back. daily=true returns the same puzzle for everyone today, with the rules text and solution to check answers against.
How games teams use Sumbloom API
- Call /v1/puzzle?type=target&daily=true once a day and cache the result.
- Render the numbers and target (or the cage grid) in your own UI.
- Check the player's answer against the returned solution.
Target puzzles follow the Sumbloom daily-game rules: every target is reachable and never in a single move.
Three real API responses (seed "demo"), shortened
| Request | Puzzle | Solution |
|---|---|---|
| /v1/puzzle?type=target&level=easy&seed=demo | Numbers 3, 6, 6, 7, 7, 15; target 28 | 7 + 6 = 13; 15 + 13 = 28 (one valid route) |
| /v1/puzzle?type=cage&level=easy&seed=demo | 4x4 grid, 7 cages: 8+, 1−, 2÷, 12×, 5+, 7+, 1− | rows 1243 / 3124 / 2431 / 4312 (unique) |
| /v1/puzzle?type=pyramid&level=medium&seed=demo | 5 rows; bottom row 3, ?, ?, 7, ? | bottom 3, 10, 10, 7, 10; top 141 (unique) |
Source: Output of the API's own code (products/sumbloom-book/api/worker.js pick + toPuzzle over its solver-checked puzzle bank) run with node on 10 Oct 2026; the live endpoint returns the same puzzle for the same seed.
FAQ
Can I use it in a paid game?
Yes, commercial use is included on paid keys; you render the puzzle in your own UI.
Is there an MCP server?
Yes, at /mcp with the get_number_puzzle tool, for AI agents.
Sumbloom API: full guide with prices and alternatives · All use cases · Store