游戏

搜索 MC Mod/插件

0次调用
1 积分/次

想给你的启动器、服务器面板或资源推荐页加上 Mod/插件搜索?这个接口一次帮你检索 Modrinth 与 SpigotMC 上的资源。

功能概述

传入关键词,即可拿到资源名称、简介、作者、下载量、评分、项目页和下载地址。可以用 source 指定只搜某个平台,用 type 过滤资源类型,用 limit 控制每个平台返回的数量。

使用须知

小贴士

默认会补全作者名与下载直链。如果只想要更快的基础搜索结果,设置enrich=false 即可降低延迟。

查询参数

query
string必填

搜索关键词,也可使用别名 q

source
string可选

搜索来源,默认 all。

type
string可选

资源类型过滤,例如 mod 或 plugin。

limit
integer可选

每个来源返回的最大条数,默认 10,最大 50。

enrich
boolean可选

是否补全下载直链与作者名,默认 true;传 false 可降低延迟。

响应

200 / 请求成功

搜索成功,返回聚合后的资源列表。

JSON

400 / 错误的请求

缺少 query 参数。

502 / 网关错误

搜索服务暂时不可用,请稍后重试。