Vendor Tools TCG Database
收藏官方服务：
资源简介：
The ultimate TCG database for UK collectors / vendors.
创建时间：
2026-08-13
原始信息汇总
数据集概述
Vendor Tools TCG Database 是一个专为集换式卡牌游戏（TCG）设计的结构化目录数据库API，提供游戏、扩展包（套装）、单卡、密封产品、市场价格、评级数量及认证图片URL等数据。该API面向TCG供应商、收藏家和产品集成场景。
核心功能
- 查询与浏览：支持列出和查找游戏（
games）、扩展包（expansions）、卡牌（cards）和密封产品（sealed）。 - 筛选与分页：列表接口支持通过
limit/offset进行分页（默认50，最大100），卡牌列表可按name、slug、rarity、collectorNumber进行组合筛选。 - 图片资源：提供专门的图片端点，用于获取游戏标志、封面、卡牌图片和密封产品图片，返回认证后的图片URL。
- 市场价格：在卡牌和密封产品的详情响应中，提供英镑（GBP）市场价格数据，包括总计和分项来源（如eBay、CardTrader、PriceCharting等）。
- 定价刷新：支持按需刷新价格（POST），但每次成功调用将消耗3个配额单位。
- 评级数量：在高级套餐中可获取卡牌的ACE和PSA评级数量。
- 数据修正：支持提交目录修正报告，供工作人员审核。
使用与认证
- 认证方式：仅需使用 RapidAPI Key 进行认证，无需单独的 Vendor Tools 密钥。
- 请求头：需要提供
X-RapidAPI-Key和X-RapidAPI-Host（vendor-tools-tcg-database.p.rapidapi.com）。 - 基础路径：所有端点位于
/v1下，例如GET /games、GET /pokemon/expansions/obsidian-flames/cards。
响应结构
- 成功响应：统一返回
{ "ok": true, "data": ... }格式。 - 列表响应：包含
data.items和data.meta（元数据包括limit,offset,count,total,hasMore）。 - 错误响应：返回
{ "ok": false, "error": { "code": "...", "message": "..." } }，常见错误代码包括unauthorized,forbidden,not_found,bad_request,rate_limited,quota_exceeded。
主要端点
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /health |
健康检查，不消耗配额 |
| GET | /games |
列出所有游戏 |
| GET | /{gameSlug} |
获取游戏详情 |
| GET | /{gameSlug}/expansions |
列出扩展包（支持排序） |
| GET | /{gameSlug}/expansions/{expansionSlug} |
获取扩展包详情 |
| GET | .../cards · .../cards/{cardSlug} |
浏览或获取单卡详情 |
| GET | .../sealed · .../sealed/{sealedSlug} |
浏览或获取密封产品详情 |
| GET | .../cards/{cardSlug}/population |
获取ACE和PSA评级数量（高级功能） |
| POST | .../cards/{cardSlug}/pricing/refresh |
刷新卡牌价格（3个配额单位） |
| POST | .../sealed/{sealedSlug}/pricing/refresh |
刷新密封产品价格（3个配额单位） |
| POST | /reports |
提交目录修正报告 |
使用限制与说明
- 成功的目录请求和图片请求均会计入 RapidAPI 套餐配额。
- 图片URL是认证端点，必须在请求中携带 RapidAPI 头，浏览器直接访问会因缺少密钥而失败。
- 价格刷新端点无论价格是否新鲜，成功调用均消耗3个配额单位。
GET /health不计入配额。
文档与参考
完整的字段级文档和示例可通过以下地址访问：
适用场景
该API专为TCG供应商、收藏家和产品集成需求而设计，提供全面的卡牌游戏数据，包括目录结构、市场定价和评级信息，适合用于构建电商平台、价格追踪工具或收藏管理应用。
