古诗词库 API

《唐诗三百首》《宋词三百首》全文，共 600 首，可按关键词、作者、朝代、体裁检索或随机抽取；本地数据，不依赖上游

数据来源：开源数据 chinese-poetry（MIT），唐诗已转为简体

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

检索诗词全文（按关键词、作者、朝代、体裁），分页返回

GET /api/poem/search

请求参数

  • keyword：关键词，匹配标题、作者和诗句；都不传则按顺序列出全部，示例 明月
  • author：作者，须完整匹配，如“李白”“苏轼”，示例 李白
  • dynasty：朝代：唐 / 宋（唐=唐诗三百首，宋=宋词三百首），示例 唐
  • type：体裁：五言绝句 / 七言绝句 / 五言律诗 / 七言律诗 / 五言古诗 / 七言古诗 / 乐府 / 词，示例 七言绝句
  • page：页码，从 1 开始，示例 1
  • size：每页条数，1~50，示例 5

返回字段

  • keyword（string|null）：实际使用的关键字（已去掉空白）；未传时为 null
  • author（string|null）：作者筛选；未传时为 null
  • dynasty（string|null）：朝代筛选；未传时为 null
  • type（string|null）：体裁筛选；未传时为 null
  • total（number）：符合条件的诗词总数；为 0 时 items 为空
  • page（number）：当前页码
  • size（number）：每页条数
  • count（number）：本页实际条数，等于 items 的长度
  • items（array）：本页诗词，按唐诗在前、宋词在后的固定顺序
  • items[].id（string）：诗词编号，如“tang-11”“song-39”，固定不变
  • items[].title（string）：标题；宋词为词牌名（部分带题目，如“水调歌头”）
  • items[].author（string）：作者
  • items[].dynasty（string）：朝代：唐 或 宋
  • items[].type（string）：体裁：五言绝句 / 七言绝句 / 五言律诗 / 七言律诗 / 五言古诗 / 七言古诗 / 乐府 / 词
  • items[].content（string）：全文，按句换行（\n）
  • items[].paragraphs（array）：按句拆分的正文，元素为字符串
  • items[].notes（array）：异文与通假注释，如“明年 一作：年年”；没有时为空数组

随机诗词全文，可按关键词、作者、朝代、体裁限定范围

GET /api/poem/random

请求参数

  • keyword：关键词，匹配标题、作者和诗句；不传则不限，示例 月
  • author：作者，须完整匹配，如“李白”“苏轼”，示例 李白
  • dynasty：朝代：唐 / 宋（唐=唐诗三百首，宋=宋词三百首），示例 唐
  • type：体裁：五言绝句 / 七言绝句 / 五言律诗 / 七言律诗 / 五言古诗 / 七言古诗 / 乐府 / 词，示例 七言绝句
  • count：条数，1~10 的整数；同一次返回的条目互不重复，示例 3

返回字段

  • keyword（string|null）：实际使用的关键字（已去掉空白）；未传时为 null
  • author（string|null）：作者筛选；未传时为 null
  • dynasty（string|null）：朝代筛选；未传时为 null
  • type（string|null）：体裁筛选；未传时为 null
  • matched（number）：符合条件的诗词总数；为 0 时 items 为空
  • count（number）：实际返回的首数，等于 items 的长度（可能少于请求的 count）
  • items（array）：随机抽取的诗词，互不重复
  • items[].id（string）：诗词编号，如“tang-11”“song-39”，固定不变
  • items[].title（string）：标题；宋词为词牌名（部分带题目，如“水调歌头”）
  • items[].author（string）：作者
  • items[].dynasty（string）：朝代：唐 或 宋
  • items[].type（string）：体裁：五言绝句 / 七言绝句 / 五言律诗 / 七言律诗 / 五言古诗 / 七言古诗 / 乐府 / 词
  • items[].content（string）：全文，按句换行（\n）
  • items[].paragraphs（array）：按句拆分的正文，元素为字符串
  • items[].notes（array）：异文与通假注释，如“明年 一作：年年”；没有时为空数组