## 成语典故 >[danger]### 会员接口，仅限会员使用，购买[API会员](https://market.topthink.com/product/210)  > 包括成语典故、来源、范例、拼音等，支持模糊搜索。 ## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)） ### 请求地址 ``` GET https://api.topthink.com/chengyu/allusion ``` ### 请求参数 | 名称 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | appCode| string|是|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | word | string | 是 | 搜索词 | | num | int | 否 | 返回数量 1-50 | | mode| int | 否 | 0严格搜索、1模糊搜索、2拼音简写搜索| ### 返回`data`参数 | 名称 | 类型 | 示例值 | 说明 | | --- | --- | --- | --- | | chengyu | string | 马到成功 | 成语 | | pinyin | string | mǎ dào chéng gōng | 拼音音标 | | diangu | string | 形容工作刚开始就取得成功。 | 典故 | | chuchu | string | 元·无名氏《小尉迟》第二折：“那老尉迟这一去，马到成功。” | 出处 | | fanli | string | 只要不轻敌，相信你们一定会～。 | 范例 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->chengyuAllusion() ->withWord('马到成功') ->request(); ``` 返回示例： ~~~ { "code":0, "message": "成功", "data": [ { "chengyu":"马到成功", "pinyin":"mǎ dào chéng gōng", "diangu":"形容工作刚开始就取得成功。", "chuchu":"元·无名氏《小尉迟》第二折：“那老尉迟这一去，马到成功。”", "fanli":"只要不轻敌，相信你们一定会～。", "pysx": "mdcg" } ] } ~~~