PokePrice API

Pokemon TCG card identification and price aggregation.

EN + JP cards with Cardmarket (EU), TCGPlayer (US), and eBay pricing.

Endpoints

GET /api/health
    → API status and card counts

GET /api/cards
    ?q=charizard              Full-text search
    ?name=Charizard           Name filter (ilike)
    ?lang=en|ja|all           Language (default: all)
    ?set=en:sv03.5            Filter by set ID
    ?local_id=006             Filter by card number within set
    ?rarity=Rare Holo         Filter by rarity
    ?type=Fire                Filter by energy type
    ?suffix=EX                Filter by suffix (EX, V, VMAX...)
    ?category=Pokemon         Filter by category
    ?dex_id=6                 Filter by Pokedex number
    ?page=1&per_page=20       Pagination
    ?include_prices=true      Include price data
    ?include_linked=true      Include linked EN↔JP card

GET /api/cards/:id
    → Full card detail with prices and linked card

GET /api/cards/:id/prices
    ?source=cardmarket        Filter by price source
    ?condition=raw            Filter by condition (raw, psa_10, psa_9, psa_8, holo)
    ?period=30d               History period (7d, 30d, 90d, 1y)

GET /api/sets
    ?lang=en|ja|all           Language filter
    ?name=151                 Name filter

GET /api/sets/:id
    → Set detail with card list

Notes:
  - All responses cached at Vercel edge for 1h, stale-while-revalidate 24h
  - Card data sourced from TCGdex (EN+JP) and JustTCG (JP)
  - Prices from Cardmarket (EUR), TCGPlayer (USD), eBay (USD)
  - EN↔JP linked cards available via include_linked=true