API端点

TCG Price Lookup API的搜索、卡牌详情、价格历史、套牌、游戏和批量查询端点的完整参考。

基础URL

https://api.tcgpricelookup.com/v1

卡牌搜索

按名称搜索所有游戏的卡牌。

GET /v1/search

查询参数：

示例：

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

卡牌详情

通过ID获取卡牌的详细价格数据。

GET /v1/cards/:id

示例：

curl "https://api.tcgpricelookup.com/v1/cards/pokemon-base1-4" \
  -H "X-API-Key: your-api-key"

价格历史

获取卡牌的价格历史（需要Trader计划或更高级别）。

GET /v1/cards/:id/prices

查询参数：

套牌列表

列出特定游戏的所有套牌。

GET /v1/sets?game=pokemon

批量查询

单次请求最多获取20张卡牌（需要Trader计划或更高级别）。

POST /v1/cards/batch

请求体：

{
  "ids": ["pokemon-base1-4", "mtg-lea-232", "yugioh-lob-005"]
}

支持的游戏标识符