getCatalogTagExclusion

解析一组 tag 排除

exclude_tag_id= 与 exclude_tag_tree= 会排除什么:接收与 /v2/catalog/works 相同的这两个参数,返回展开后的 tag id,以及带有其中任一 tag 的全部作品 id。站点用自己的表出作品列表时,剔掉 work_ids 即可套用读者的屏蔽;自有 tag 镜像的站点也可以改用 tag_ids 匹配。至少要给一个参数。响应只取决于参数,请按参数集缓存。可匿名调用,按 IP 地址限流;应用密钥或带 catalog:read 的用户访问令牌各有更高的额度。

get/v2/catalog/tag-exclusion
scope catalog:read可匿名调用(不带凭据按 IPv4 地址或 IPv6 /64 限流(默认 30 次/分钟、1,000 次/天);带 nmk_ 应用密钥或带 catalog:read 的用户访问令牌则走各自更高的额度)

参数

参数类型位置说明
exclude_tag_idstringquery

逗号分隔的规范 tag id,最多 100 个。每个只排除带有它自己的作品。

exclude_tag_treestringquery

逗号分隔的规范 tag id,最多 100 个。每个排除带有它自己或其下任一 tag 的作品。

响应

  • objectstring 必填

    类型判别字段,恒为 tag_exclusion。

    枚举tag_exclusion
  • tag_idsstring[] 必填

    参数排除的全部 tag:精确 id,以及每个树 id 连同其下所有 tag。升序。永不为 null。

  • work_idsstring[] 必填

    带有 tag_ids 中任一 tag 的全部 catalog 作品,不论来源、剧透等级与分级。升序。永不为 null。即 /v2/catalog/works 在相同参数下剔除的作品,用自己的表出列表的站点剔掉它们即可保持一致。

请求示例

cURL
curl "https://api.nextmoe.dev/v2/catalog/tag-exclusion"

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

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