## 元曲三百首 >[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":"秦漢皇陵一片茫茫野草，世世代代興亡更替，就像那月影有圓有缺。山人的家里圖書堆滿案桌，當窗可見松桂姿影，滿地都是野生薇蕨。侯門深如海何須去拜見，空中的白云盡可欣賞怡悅。到如今紛繁世事難以言說。茫茫天地之間見不到一個英雄，見不到一個豪杰。" } ] } ~~~