明日方舟剧情搜索

GETPOST 明日方舟

搜索明日方舟剧情对话,支持关键词+类型筛选+分页

GET https://api.tinyaii.cn/v1/ark/search

请求参数

参数名类型必填说明示例
keywordstring必填搜索关键词(角色名/台词)—
type_filterstring可选剧情类型:Main(主线)/Memory(干员密录)/Activity(活动)/Rogue(肉鸽),不传则不限—
offsetint可选分页偏移,默认0—
limitint可选每页条数,1-50,默认20—

返回字段

字段类型说明
codeint状态码
data.keywordstring搜索关键词
data.totalint结果总数
data.has_morebool是否有更多结果
data.resultsarray结果列表
data.results[].story_idstring剧情ID
data.results[].typestring剧情类型代码
data.results[].type_namestring剧情类型中文名
data.results[].namestring剧情名称
data.results[].zonestring所属章节
data.results[].snippetsarray匹配片段

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "keyword": "阿米娅",
    "total": 380,
    "has_more": true,
    "results": [
      {
        "story_id": "obt/main/level_main_00-01_beg",
        "type": "Main",
        "type_name": "主线剧情",
        "name": "0-1 坍塌 行动前",
        "zone": "黑暗时代·上"
      }
    ]
  }
}

调用示例

curl "https://api.tinyaii.cn/v1/ark/search?keyword=<keyword>" \
  -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch("https://api.tinyaii.cn/v1/ark/search?keyword=<keyword>", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());
import requests

resp = requests.get(
    "https://api.tinyaii.cn/v1/ark/search",
    params={"keyword": "<keyword>"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=10,
)
print(resp.json())

把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。