Sudoku API terms & attribution
The conditions for using the Sudokumax API and MCP service.
On this page
Free to use. Credit Sudokumax.
Everything you publish using the service must reference the website. Online, make that reference a visible, clickable link. Offline, print the website address.
These API terms supplement the Sudokumax Terms of Use. The summary above is a quick reference; the conditions below apply to your use of the service.
01Free API access
API calls are free. Create an account and generate an API key before using the service. No payment details are required.
Free access is conditional on meeting the attribution requirement and following the service limits.
Use the outputs in your business
You may use API-generated puzzles, solutions and worksheet outputs commercially or non-commercially. This includes storing, copying, modifying, embedding, redistributing and selling them in apps, websites, books, courses and other products, provided every published output meets the attribution requirement below.
This permission is non-exclusive, worldwide and continues for outputs you lawfully obtained, including after your API access ends, as long as you continue to meet these conditions. It does not promise continued access to hosted links or downloads; keep your own copies.
For authorized API requests and use of API-generated outputs, these API terms take precedence over conflicting provisions of the general Terms of Use, including automated puzzle extraction restrictions, personal-use application licensing and general content reservations. This exception does not authorize scraping the website, bypassing access controls or redistributing our private engine, source code or other website content. No exclusive ownership of a Sudoku grid or ownership of Sudokumax trademarks is granted.
You may keep the Sudokumax branding supplied on generated worksheets when distributing them. You may also use your own layout with the required credit. The separately downloadable developer kit has its own MIT software license.
02Credit Sudokumax on every published output
Every puzzle, game, worksheet, answer sheet, image or other output you publish using this service must visibly reference Sudokumax. This applies when you modify, embed, print, distribute or commercially publish the output.
When you publish online
Include a visible, clickable hyperlink to https://sudokumax.com alongside the puzzle or game. For example, display “Created with Sudokumax” and link it to the website.
<a href="https://sudokumax.com">Created with Sudokumax</a>A hidden link or a credit that appears only in source code does not meet this requirement.
When you publish offline
Print sudokumax.com legibly on each puzzle, worksheet, answer sheet or other exported item. A QR code may accompany the address, but does not replace it.
When you edit or redistribute an export
Keep the attribution in generated PDFs and other exports. If you create your own layout or share an image online, preserve the visible credit and add the clickable website link to the surrounding page or caption.
03API keys & access controls
Keep your keys secret and call the API from your server. Do not embed a secret key in public browser code or a distributed app. You can revoke your keys at any time from your API-key dashboard.
Sudokumax may suspend an account or revoke a key for missing attribution, abuse, attempts to bypass limits or other breaches of these terms.
Revocation blocks future authenticated API and MCP requests, including PDF download links associated with the key. It cannot remove files already downloaded or recall public puzzle links. Those outputs still require attribution.
04Service limits & public links
- Puzzles per request
- Up to 20
- JSON request body
- Up to 16 KiB
- Authenticated requests
- 6,000 per account per minute
- PDF download links
- Expire after 24 hours
Additional service limits may apply. See limits and error responses for how to handle them.
Individual puzzle links encode grids; short collection links resolve public grids stored by Sudokumax. Anyone with a complete public link can open it. Do not put private information in puzzle links.
05Account data & recovery
To operate this service, we store your account email, password hash, hashed credentials, accepted terms version, key names, usage counters and access-control records.
Supabase manages sign-in, email confirmation and password recovery. Use the same account as the Sudokumax website and apps. Changing your password revokes existing developer API keys and PDF download grants.
Read the privacy policy and Terms of Use for the broader service terms and contact details.