FastAPI backend for Pokémon TCG search, pricing, inventory, and app workflows.
SaveRoom Pokémon Card Database API is the backend platform behind SaveRoom's Pokémon TCG tools. It exposes card search, card detail, images, pricing, inventory, listing, sales, fixture, and health endpoints through a FastAPI/OpenAPI service.
Current stable release: v12.2.0
- App-ready API: built for scanner, collection, inventory, and seller workflows.
- Multilingual card data: supports 18 languages, canonical cards, printings, variants, and set metadata.
- Pricing intelligence: stores market price, history, evidence, and source guardrails.
- Operational shape: auth, quotas, health checks, image delivery, fixtures, tests, and docs.
Flutter / client apps
│ HTTP / REST
▼
FastAPI service ── OpenAPI 3.1 docs
│
├── Cards / Sets / Printings
├── Images / Fixtures / Health
├── Pricing / Sales / Listings
└── Inventory / Locations / Reports
│
▼
SQLite data store + local image cache
git clone https://github.com/MatthewRobertLotts/SaveRoom-Pokemon-Database-API.git
cd SaveRoom-Pokemon-Database-API
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python3 pokemon_db_v2_fastapi.pyOpen: http://localhost:8765/docs
| Domain | Purpose |
|---|---|
| Cards | Search, detail, variants, printings, multilingual metadata |
| Sets | Set listing, set detail, card-by-set workflows |
| Pricing | Market price, history, evidence chain, source adapters |
| Inventory | Physical stock, locations, status, workflow fields |
| Listings | Listing assistant endpoints and deterministic listing output |
| Images | Asset lookup and signed/local delivery paths |
| Fixtures | Stable app-development and QA payloads |
| Health | Runtime status, diagnostics, and monitoring endpoints |
Runtime/API entrypoints stay at the repository root. Historical import, scraper, recovery, old research notes, and one-off data build scripts live under scripts/legacy/ and docs/archive/ so the public root stays readable without deleting project history.
Public CI runs a portable subset that does not require private SQLite/image assets. Full local verification runs with the dataset mounted.
See docs/ARCHITECTURE.md for the staged refactor path for the legacy FastAPI entrypoint.
| Project | Purpose |
|---|---|
| SaveRoom Scanner App | Flutter frontend consuming this API |
| This repo | Backend API and data platform |
Apache License 2.0. See LICENSE.