APIエンドポイント

TCG Price Lookup APIの検索、カード詳細、価格履歴、セット、ゲーム、一括検索エンドポイントの完全リファレンス。

ベースURL

https://api.tcgpricelookup.com/v1

すべてのエンドポイントには X-API-Key ヘッダーが必要です。認証をご覧ください。

カード検索

対応するすべてのゲームにわたってカード名で検索します。価格データを含むページネーションされた結果を返します。

GET /v1/search

パラメータ

パラメータ	型	必須	デフォルト	説明
`q`	string	はい	—	検索するカード名
`game`	string	いいえ	all	ゲームでフィルタリング: `pokemon`, `mtg`, `yugioh`, `lorcana`, `onepiece`, `swu`, `fab`, `pokemonjp`
`set`	string	いいえ	all	セットコードでフィルタリング（例: `sv4`, `mh3`）
`limit`	integer	いいえ	20	1ページあたりの結果数（最大100）
`offset`	integer	いいえ	0	スキップする結果数

リクエスト例

curl -H "X-API-Key: your-key" \
  "https://api.tcgpricelookup.com/v1/search?q=charizard&game=pokemon&limit=5"

レスポンス例

{
  "data": [
    {
      "id": "pokemon-sv4-charizard-ex-006",
      "name": "Charizard ex",
      "game": "pokemon",
      "set": "Paradox Rift",
      "rarity": "Double Rare",
      "prices": {
        "market": 42.50,
        "conditions": {
          "near_mint": 42.50,
          "lightly_played": 38.25
        }
      }
    }
  ],
  "total": 47,
  "limit": 5,
  "offset": 0
}

カード詳細

特定のカードのすべてのコンディションとグレーデッド価格を含む完全な価格データを取得します。

GET /v1/cards/{id}

パラメータ

パラメータ	型	必須	説明
`cardId`	string	はい	カードID（検索結果から取得）

リクエスト例

curl -H "X-API-Key: your-key" \
  "https://api.tcgpricelookup.com/v1/cards/pokemon-sv4-charizard-ex-006"

レスポンス例

{
  "data": {
    "id": "pokemon-sv4-charizard-ex-006",
    "name": "Charizard ex",
    "game": "pokemon",
    "set": "Paradox Rift",
    "setCode": "sv4",
    "number": "006",
    "rarity": "Double Rare",
    "image": "https://images.tcgpricelookup.com/pokemon/sv4/006.jpg",
    "prices": {
      "market": 42.50,
      "low": 35.00,
      "mid": 41.00,
      "high": 55.00,
      "conditions": {
        "near_mint": 42.50,
        "lightly_played": 38.25,
        "moderately_played": 34.00,
        "heavily_played": 29.75,
        "damaged": 21.25
      },
      "graded": {
        "psa_10": 125.00,
        "psa_9": 75.00,
        "bgs_9_5": 110.00,
        "cgc_9_5": 95.00
      }
    },
    "sources": ["tcgplayer", "ebay"],
    "updatedAt": "2026-04-10T12:00:00Z"
  }
}

価格履歴

カードの過去の価格データを取得します。トレンドの追跡やチャートの作成に便利です。Traderプラン以上が必要です。

GET /v1/cards/{id}/history

パラメータ

パラメータ	型	必須	デフォルト	説明
`cardId`	string	はい	—	カードID
`period`	string	いいえ	30d	期間: `7d`, `30d`, `90d`, `1y`, `all`

リクエスト例

curl -H "X-API-Key: your-key" \
  "https://api.tcgpricelookup.com/v1/cards/pokemon-sv4-charizard-ex-006/history?period=30d"

レスポンス例

{
  "data": {
    "cardId": "pokemon-sv4-charizard-ex-006",
    "period": "30d",
    "history": [
      { "date": "2026-03-11", "market": 38.00, "low": 32.00, "high": 48.00 },
      { "date": "2026-03-12", "market": 39.50, "low": 33.00, "high": 49.00 },
      { "date": "2026-04-10", "market": 42.50, "low": 35.00, "high": 55.00 }
    ]
  }
}

セット一覧

利用可能なすべてのカードセットをゲームでオプションフィルタリングして一覧表示します。

GET /v1/sets

パラメータ

パラメータ	型	必須	デフォルト	説明
`game`	string	いいえ	all	ゲームでフィルタリング
`limit`	integer	いいえ	50	1ページあたりの結果数（最大200）
`offset`	integer	いいえ	0	スキップする結果数

リクエスト例

curl -H "X-API-Key: your-key" \
  "https://api.tcgpricelookup.com/v1/sets?game=pokemon&limit=3"

レスポンス例

{
  "data": [
    {
      "code": "sv4",
      "name": "Paradox Rift",
      "game": "pokemon",
      "cardCount": 182,
      "releaseDate": "2023-11-03"
    },
    {
      "code": "sv3",
      "name": "Obsidian Flames",
      "game": "pokemon",
      "cardCount": 197,
      "releaseDate": "2023-08-11"
    }
  ],
  "total": 156,
  "limit": 3,
  "offset": 0
}

ゲーム一覧

カード数とメタデータを含む、対応しているすべてのゲームを一覧表示します。

GET /v1/games

リクエスト例

curl -H "X-API-Key: your-key" \
  "https://api.tcgpricelookup.com/v1/games"

レスポンス例

{
  "data": [
    { "id": "pokemon", "name": "Pokemon", "cardCount": 30000, "setCount": 156 },
    { "id": "mtg", "name": "Magic: The Gathering", "cardCount": 100000, "setCount": 320 },
    { "id": "yugioh", "name": "Yu-Gi-Oh!", "cardCount": 40000, "setCount": 280 },
    { "id": "lorcana", "name": "Disney Lorcana", "cardCount": 3000, "setCount": 6 },
    { "id": "onepiece", "name": "One Piece", "cardCount": 6000, "setCount": 12 },
    { "id": "swu", "name": "Star Wars: Unlimited", "cardCount": 2500, "setCount": 4 },
    { "id": "fab", "name": "Flesh and Blood", "cardCount": 8000, "setCount": 35 },
    { "id": "pokemonjp", "name": "Pokemon Japan", "cardCount": 20000, "setCount": 120 }
  ]
}

一括検索

1回のリクエストで複数のカードをIDで取得します。個別リクエストよりもはるかに効率的です。

POST /v1/cards/batch

リクエストボディ

{
  "ids": ["pokemon-sv4-charizard-ex-006", "mtg-mh3-flare-of-cultivation", "yugioh-lede-fiendsmith"]
}

フィールド	型	必須	説明
`ids`	string[]	はい	カードIDの配列（最大20件）

リクエスト例

curl -X POST \
  -H "X-API-Key: your-key" \
  -H "Content-Type: application/json" \
  -d '{"ids":["pokemon-sv4-charizard-ex-006","mtg-mh3-flare-of-cultivation"]}' \
  "https://api.tcgpricelookup.com/v1/cards/batch"

レスポンス例

{
  "data": [
    {
      "id": "pokemon-sv4-charizard-ex-006",
      "name": "Charizard ex",
      "game": "pokemon",
      "prices": { "market": 42.50 }
    },
    {
      "id": "mtg-mh3-flare-of-cultivation",
      "name": "Flare of Cultivation",
      "game": "mtg",
      "prices": { "market": 12.75 }
    }
  ]
}

存在しないカードはレスポンスから除外されます（エラーにはなりません）。不足しているカードを検出するには、レスポンスの長さと入力を比較してください。