あなたのアプリケーションに、カタログ、画像、参考価格を。

• GET/api/v1/games

  公開中のゲーム（スラッグ、名称、種類）

• GET/api/v1/sets?game={slug}&page=1&pageSize=50

  ゲームのセット一覧（コード、名称、発売日、カード枚数）

• GET/api/v1/cards?game={slug}&q={text}&set={setId}&number={collectorNumber}

  ゲーム、テキスト、セット、コレクター番号によるカード検索

• GET/api/v1/cards/{id}

  画像、バリエーション、価格、価格推移、状態の段階を含む単一のカード

• GET/api/v1/conditions

  状態の段階（コードと名称）

一覧はページ単位で取得できます（page、pageSize）。meta には total と generatedAt が含まれます。

成功時のレスポンスには data と meta が含まれます。エラーは code と message を持つ error として返されます。例：unauthorized（401）、rate_limited（429）。

例：/api/v1/cards/{id} のレスポンス

{
  "data": {
    "id": 1842113,
    "name": "Example Card",
    "game": "pokemon",
    "set": {
      "id": 7731,
      "code": "EXA",
      "name": "Example Set"
    },
    "collectorNumber": "025/165",
    "rarity": "Rare",
    "imageUrl": "https://cardmarket.pro/media/example-listing.jpg",
    "variants": [
      {
        "id": 90211,
        "language": "de",
        "finish": "holo"
      },
      {
        "id": 90212,
        "language": "en",
        "finish": "normal"
      }
    ],
    "prices": {
      "currency": "EUR",
      "trendMinor": 1250,
      "lowMinor": 990,
      "asOf": "2026-11-07"
    },
    "images": {
      "listing": "https://cardmarket.pro/media/example-listing.jpg",
      "detail": "https://cardmarket.pro/media/example-detail.jpg"
    },
    "priceHistory": [
      {
        "date": "2026-11-06",
        "trendMinor": 1230
      },
      {
        "date": "2026-11-07",
        "trendMinor": 1250
      }
    ],
    "conditionScale": [
      "MT",
      "NM",
      "EX",
      "GD",
      "LP",
      "PL",
      "PO"
    ]
  },
  "meta": {
    "generatedAt": "2026-11-08T15:53:47.797Z"
  }
}