Skip to main content

PikaQian API

Welcome to the PikaQian API — a REST API for Simplified Chinese Pokémon TCG data: card metadata, sets, Pokémon, real auction-derived pricing, and recent sales. It's the same data that powers pikaqian.com.

Base URLhttps://api.pikaqian.com
Version/v1 — path-based; new majors get /v2
AuthX-API-Key: pk_live_… — required on every data request
FormatJSON, snake_case, UTC ISO-8601 dates, money in USD cents

What you get​

  • Sets — 60+ Simplified Chinese sets across the ScarletViolet, SwordShield, and SunMoon series.
  • Cards — 13,000+ cards (base prints plus reverse-holo and other variant prints) with English (name) and Chinese (local_name) names, rarity, type, element, and a public CDN image URL.
  • Pokémon — the national-dex index, searchable by English or Chinese name.
  • Pricing — current raw and graded (PSA 8/9/10 and other 8/9/10) prices in USD cents, derived from real eBay sales of the Chinese cards.
  • Sales — the underlying recent listings behind those prices (last 90 days).
  • Search — one query across cards, sets, and Pokémon.

Design at a glance​

A few conventions worth knowing up front (each has its own guide):

  • Every data request needs an API key. There is no anonymous access. See Authentication.
  • Three tiers — free (metadata), hobby (+ raw prices), pro (+ graded prices and sales). The JSON shape is identical across tiers; values you can't see are null. See Tiers & rate limits.
  • Keyset cursor pagination — no offset/page. See Pagination.
  • Structured filters, no query DSL. See Filtering & sorting.
  • Consistent error envelope with a stable code and a request_id. See Errors.

Discovery​

GET /v1 returns version and documentation metadata and requires no API key, so you can confirm the API is reachable before signing up:

curl https://api.pikaqian.com/v1
{
  "version": "v1",
  "title": "pikaqian-api",
  "documentation": "https://pikaqian.com/docs"
}

Ready to make your first authenticated call? Head to the Quickstart.