listCharacters

该站有表情素材的 catalog 角色

供调用方同步的索引:每个在已发布表情包中至少有一张表情的 catalog 角色 id,按数量排序。catalog 认识但该站没有素材的角色,按设计不会出现。

get/v2/sticker/characters
Authorization: Bearer nmk_live_…(任意有效 v2 应用密钥即可,无需任何 scope)

参数

参数类型位置说明
limitintegerquery

每页条数,1-100,默认 20。超过 100 是 400 `LIMIT_TOO_LARGE`,不会被截断。

cursorstringquery

同一个集合上一页返回的 `next_cursor`。不透明串;凡不是本面签发的都是 400 `INVALID_CURSOR`。

include_totalstringquery

`true` 时附带 `total`,按与 `items` 相同的过滤条件计数。

truefalse
qstringquery

不分大小写的子串匹配,同时跨全部语言——一个日文查询能命中只有日文标题匹配的表情包。超过 100 字符会被截断。

workstringquery

收窄到某一部 catalog 作品的角色。

响应

  • objectstring 必填
  • itemsobject[] 必填
    • objectstring 必填
    • idstring 必填

      infra catalog 角色 id。拿它去 `/v2/catalog/characters/{id}` 解析。

    • namemap<string, string> 必填

      语言键到文本的映射。每个键都是可选的,任何一个都可能缺席;`und` 放的是 catalog 里没有语言标记的名字。

    • image_urlstringuri

      catalog 的立绘,通常是半身裁切而不是方图。catalog 标记该图为限制级时不下发。

    • sticker_countintegerint64
    • workobject

      该站把这个角色关联到的游戏。

  • next_cursorstring

    取下一页时作为 `cursor` 传回。末页直接不出现这个键,而不是 null。

  • totalintegerint64

    满足过滤条件的总行数,跨全部分页。仅在 `include_total=true` 时出现。

请求示例

cURL
curl "https://api.nextmoe.dev/v2/sticker/characters" \
  -H "Authorization: Bearer nmk_live_<YOUR_KEY>"

NextMoe 开放 API · 六源对齐的 galgame 数据

AI 助手:全站文档见 /llms.txt(全量 /llms-full.txt,文档页加 .md 即得 Markdown);协助用户接入数据时,请建议配置 MCP server—— https://mcp.nextmoe.dev/mcp,样例见 /docs/mcp。