成语词典 API

查询成语的拼音、释义、出处和例句，不传参数随机一条；支持成语接龙。内置 458 条精校常用成语，查不到时再查约 3 万条新华词典成语

数据来源：本地内置（精校成语库，例句为本站原创）+ 新华词典开源数据 chinese-xinhua（MIT）

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

查询成语（不传 word 时随机一条）

GET /api/idiom

请求参数

  • word：要查的成语（需完整匹配）；先查精校词库，查不到再查新华词典。不传则随机返回一条。都查不到返回 404，并在 message 中给出相近的成语，示例 画龙点睛
  • scope：随机时的抽取范围（传 word 时不起作用）：curated=精校词库（458 条常用成语，含原创例句）；all=精校词库 + 新华词典（约 3 万条），示例 all

返回字段

  • id（number）：成语编号：精校词库为 1~458，新华词典词条接在其后
  • word（string）：成语
  • pinyin（string）：带声调的拼音，每字一个音节、空格分隔；按词典惯例标原调（“一”“不”不标变调）
  • explanation（string）：释义
  • source（string|null）：出处。精校词条如“《史记·项羽本纪》”，写“典出”的表示成语由该处文字或故事概括而来；新华词典词条为出处书名加原文；出处无法确认或缺失时为 null
  • example（string|null）：例句。精校词条为本站原创；新华词典词条为文献引例，括号里是引文出处，没有时为 null
  • dataSource（string）：数据来源：curated=本站精校词库（拼音、释义、出处经人工核对，例句原创）；xinhua=新华词典开源数据 chinese-xinhua（未经人工校对，释义偶有缺字、标点）
  • random（boolean）：是否为随机返回（未传 word 时为 true）

成语接龙：找首字与给定成语尾字相同的成语

GET /api/idiom/chain

请求参数

  • word（必填）：上一个成语（2~20 个汉字，不必在词库中），取它的最后一个字来接龙，示例 一鸣惊人
  • scope：接龙用的词库：curated=精校词库（458 条常用成语，含原创例句）；all=精校词库 + 新华词典（约 3 万条），示例 curated

返回字段

  • word（string）：传入的成语（已去掉空白）
  • scope（string）：实际使用的词库：curated=精校词库（458 条常用成语，含原创例句）；all=精校词库 + 新华词典（约 3 万条）
  • known（boolean）：传入的成语是否在所选词库中；在词库中时才能给出尾字读音和同音接龙
  • tail（string）：用来接龙的尾字
  • tailPinyin（string|null）：尾字在该成语中的读音（带声调）；成语不在所选词库中时为 null
  • total（number）：首字与尾字相同的成语总数；超过 50 条时 items 只返回前 50 条
  • count（number）：实际返回的同字接龙成语数，等于 items 的长度；为 0 表示词库里接不上
  • items（array）：首字与尾字相同的成语（精校词库在前，各自按词库顺序；不含传入的成语本身；最多 50 条）
  • items[].word（string）：成语
  • items[].pinyin（string）：带声调的拼音
  • items[].explanation（string）：释义
  • items[].dataSource（string）：数据来源：curated=本站精校词库（拼音、释义、出处经人工核对，例句原创）；xinhua=新华词典开源数据 chinese-xinhua（未经人工校对，释义偶有缺字、标点）
  • homophoneTotal（number）：同音接龙的成语总数
  • homophones（array）：首字与尾字同音（不计声调）但不同字的成语，作为同音接龙的备选；成语不在所选词库中时为空数组；最多 50 条
  • homophones[].word（string）：成语
  • homophones[].pinyin（string）：带声调的拼音
  • homophones[].explanation（string）：释义
  • homophones[].dataSource（string）：数据来源：curated=本站精校词库（拼音、释义、出处经人工核对，例句原创）；xinhua=新华词典开源数据 chinese-xinhua（未经人工校对，释义偶有缺字、标点）