Magic The Gathering

简介

MTG API（magicthegathering.io）以 JSON 提供万智牌卡牌数据——卡牌、系列、类型和裁定。免密钥且免费，是卡牌搜索应用、套牌构建器和收藏追踪器的经典数据源。

注：该项目由社区维护，数据可能滞后于官方发布。最新系列请查看本站其他条目（Scryfall 等社区镜像）。

快速开始

搜索卡牌（实测可用——黑莲花）：

curl "https://api.magicthegathering.io/v1/cards?name=Black+Lotus"

按 multiverse ID 查询：

curl "https://api.magicthegathering.io/v1/cards/3"

全部系列：

curl "https://api.magicthegathering.io/v1/sets"

按类型/颜色筛选：

curl "https://api.magicthegathering.io/v1/cards?type=creature&colors=red&pageSize=5"

卡牌数据包含

name、manaCost、type、rarity、text（规则文本）、power/toughness（生物）、imageUrl、set、number、artist 等。

认证方式

无需认证——免密钥。

速率限制与注意事项

• 免费；没有文档化的硬性限制——请礼貌使用。
• 通过 page / pageSize 分页；响应含 totalCount。
• 数据集对 2010 年代中期的系列覆盖可靠；非常新的系列可能缺失——新卡请验证覆盖情况。
• 支持 HTTPS——请使用（文档仍显示 http）。

常见问题

MTG API 免费吗？ 是的——免费且免密钥。

可以按名称搜索吗？ 可以——?name=Black+Lotus（模糊）或 name=Black Lotus（近似精确）。

数据新吗？ 社区维护——旧系列可靠；新系列可能滞后。最新数据建议用 Scryfall（本站也有收录）。