Developer · Usage & Terms

Building with the DeckTuner API

What the API provides, what we ask in return, and what to expect day-to-day.

Looking for the endpoints? Jump to the API reference →

Overview

The DeckTuner API is a public, read-only JSON API that exposes per-game settings produced by our AI-driven testing fleet. No sign-up, no API key — just GET requests and JSON responses.

Designed for community tools, dashboards, Decky plugins, and anyone who wants to build on top of our data. Base URL: https://api.decktuner.app/v1.

Terms of use

  • Attribute us — if you display DeckTuner data publicly, credit "DeckTuner" with a link back to decktuner.app.
  • Respect the cache — honour the Cache-Control header on every response. Don't add cache-busting query params or poll faster than the data changes.
  • No bulk resale of raw data — mirroring the dataset and re-selling it verbatim is not okay. Derivative tools, overlays, and interfaces built on top of the data are encouraged.
  • Be a good neighbour — sustained abusive traffic patterns may result in your access being blocked without notice.
  • No warranty — settings are AI-generated best-effort. We test them but can't guarantee correctness for every device, firmware, or driver combination.

Caching & freshness

Responses carry a Cache-Control header. Honour it on your end and we'll both benefit. Data may be slightly behind real-time — typically by no more than a minute or two on the client, longer at intermediary caches.

If you need stronger freshness guarantees than our headers indicate, this API isn't the right surface for your use case yet — reach out.

Privacy

The API exposes only public game metadata and test results — no user data, no analytics, no tracking. DeckTuner has no concept of an API consumer: we don't log who calls it or what they ask for beyond standard access logs.

FAQ

Why might I see stale data?

Responses are cached. When a game is re-tested, it may take a short while for the new data to propagate. This is intentional and is what lets us keep the API open.

Can I embed the data in my app?

Yes — that's exactly what it's for. Credit DeckTuner and link back.

How do I report a bug or request an endpoint?

Email hello@decktuner.app with a brief description.