## 元曲三百首 >[danger]### 会员接口，仅限会员使用，购买[API会员](https://market.topthink.com/product/210)  > 元曲三百首接口，返回词曲类型、作者、批注、翻译等。 ## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)） ### 请求地址 ``` GET https://api.topthink.com/literary/yuan ``` ### 请求参数 | 名称 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | appCode| string|是|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | word | string | 是 | 搜索词，曲名或作者 | | num | int | 否 | 返回数量，取值1-10 | | page | int | 否 | 翻页 | ### 返回`data`参数 | 名称 | 类型 | 示例值 | 说明 | | --- | --- | --- | --- | | chapter | string | 散曲 | 词曲类型 | | title | string | 折桂令 | 曲名 | | content | string | 草茫茫秦汉陵阙，世代兴亡，却便似月影圆缺...... | 内容 | | note | string | 拟：模拟。张鸣善；元代后期散曲作家...... | 批注 | | author | string | 倪 瓒 | 作者 | | translation | string | 秦汉皇陵一片茫茫野草，世世代代兴亡更替...... | 译文 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->literaryYuan() ->withWord('折桂令') ->request(); ``` 返回示例： ~~~ { "code":0, "message": "成功", "data": [ { "chapter":"散曲", "title":"折桂令", "content":"草茫茫秦汉陵阙，世代兴亡，却便似月影圆缺。山人室堆案图书，当窗松桂，满地薇蕨。侯门深何须刺谒，白云自可怡悦。到如今世事难说，天地间不见一个英雄，不见一个豪杰。", "note":"拟：模拟。张鸣善；元代后期散曲作家。从内容看，可能是模仿张鸣善《水仙子·讥时》。陵阙：指帝王的坟墓。山人家：山居的人，作者自称。堆案图书：形容藏书丰富。案，桌子。薇蕨：皆草本植物。伯夷、齐叔不食周粟，隐居首阳山、采薇而食。后世以“薇蕨”为隐者之粮。侯门。泛指官宦显贵人家。刺谒：求见、拜访。刺，类似后来的名片。", "author":"倪 瓒", "translation":"秦汉皇陵一片茫茫野草，世世代代兴亡更替，就像那月影有圆有缺。山人的家里图书堆满案桌，当窗可见松桂姿影，满地都是野生薇蕨。侯门深如海何须去拜见，空中的白云尽可欣赏怡悦。到如今纷繁世事难以言说。茫茫天地之间见不到一个英雄，见不到一个豪杰。" } ] } ~~~