首页 › API 文档 › 游戏数据

MC Mod/插件搜索

搜索Minecraft Mod和服务器插件,同时检索Modrinth(Fabric/Forge/NeoForge Mod、光影包、资源包、整合包)和SpigotMC(Bukkit/Spigot/Paper插件)

接口地址

GET/POST https://api.tinyaii.cn/v1/mc/mod-search

分类:游戏数据 · 返回格式:JSON · 鉴权:API Key(URL 参数 apikey 或请求头 Authorization: Bearer)

请求参数

参数名类型必填说明
keywordstring是搜索关键词
sourcestring否平台筛选:modrinth(Mod/光影/资源包/整合包)/ spigot(服务端插件),不填则搜全部
typestring否Modrinth资源类型:mod / shader(光影包)/ resourcepack(资源包)/ modpack(整合包),不填则搜全部类型
limitinteger否每个平台返回数量(1-20,默认5)

返回字段

字段名类型说明
data.keywordstring搜索关键词
data.modrinth_totalintegerModrinth匹配总数
data.modrinth[].titlestring项目名称
data.modrinth[].descriptionstring项目简介
data.modrinth[].authorstring作者
data.modrinth[].project_typestring项目类型(Mod/光影包/资源包/整合包)
data.modrinth[].downloadsinteger下载量
data.modrinth[].categoriesarray分类标签(fabric/forge/neoforge等)
data.modrinth[].versionsarray支持的MC版本
data.modrinth[].icon_urlstring项目图标URL
data.modrinth[].project_urlstring项目主页URL
data.spigot[].namestring插件名称
data.spigot[].descriptionstring插件简介
data.spigot[].authorstring作者
data.spigot[].downloadsinteger下载量
data.spigot[].ratingnumber评分(1-5)
data.spigot[].tested_versionsarray测试通过的MC版本
data.spigot[].project_urlstring插件主页URL

返回示例

{
  "code": 200,
  "data": {
    "keyword": "essentials",
    "modrinth_total": 438,
    "modrinth_count": 3,
    "modrinth": [
      {
        "title": "Inventory Essentials",
        "description": "...",
        "author": "BlayTheNinth",
        "project_type": "Mod",
        "downloads": 1783170,
        "categories": [
          "fabric",
          "forge"
        ],
        "versions": [
          "1.20.4"
        ],
        "project_url": "https://modrinth.com/mod/inventory-essentials"
      }
    ],
    "spigot_count": 3,
    "spigot": [
      {
        "name": "EssentialsX",
        "description": "The modern Essentials suite",
        "author": "EssentialsX",
        "downloads": 5859656,
        "rating": 4.5,
        "tested_versions": [
          "1.20",
          "1.21"
        ],
        "project_url": "https://www.spigotmc.org/resources/..."
      }
    ]
  },
  "message": "success"
}

调用示例

curl "https://api.tinyaii.cn/v1/mc/mod-search?apikey=YOUR_KEY&keyword=&source=&type="

把 YOUR_KEY 换成你在 用户中心 获取的 API Key,在浏览器打开同样地址也能直接看到结果。

相关接口(游戏数据)

本站收录 353 个可免费调用的 API 接口,查看完整开发文档 或 注册获取 API Key。