API 文档
接口地址: https://api.gugudata.com/text/chinesepoem
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/text/chinesepoem?appkey=YOUR_APPKEY&keywords=%e7%83%bd%e7%81%ab&pagesize=10&pagenumber=1&type=&searchtype=all
数据预览: https://www.gugudata.com/preview/chinesepoem
接口测试: https://api.gugudata.com/text/chinesepoem/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
付费后获取的 APPKEY |
| keywords |
string |
否 |
无 |
可选;不传或空值时浏览目录。按 searchtype 进行字面包含匹配,特殊符号不作为正则表达式执行。 |
| pagesize |
integer |
否 |
10 |
分页参数,每页总条数,取值范围在 1 ~ 20 之间 |
| pagenumber |
integer |
否 |
1 |
分页参数,第几页 |
| type |
string |
否 |
无 |
数据分类,可选参数为(tang, song, ci)。唐诗: tang | 宋诗: song | 宋词: ci,不传递或空值则不进行过滤 |
| searchtype |
string |
否 |
all |
默认 all。title 匹配标题或词牌;author 匹配作者;content 保留正文及词牌匹配;all 联合匹配作者、标题、正文和词牌;未知值沿用 all。只有正文匹配补充对应繁体形式。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.StatusCode |
integer |
业务状态码:100 成功;501 参数错误;502 请求频率受限;503 商品权益过期;504 APPKEY 无效;505 调用额度不足;901 处理或依赖失败。 |
| DataStatus.StatusDescription |
string |
接口返回状态说明 |
| DataStatus.ResponseDateTime |
string |
接口数据返回时间 |
| DataStatus.DataTotalCount |
integer |
此条件下的总数据量,一般用于分页计算 |
| DataStatus.RequestParameter |
string |
真实可读的 keywords/pagesize/pagenumber/type/searchtype,不包含鉴权凭据;Demo 与烽火样例对应。 |
| Data[].Title |
string |
诗歌标题或宋词词牌名 |
| Data[].Author |
string |
作者名 |
| Data[].Content |
array |
诗歌或词的内容,格式为 string 数组 |
| Data[].Type |
string |
类型,分为:唐诗 | 宋诗 | 宋词 |
仅展示部分示例数据,数组最多展示 3 项,长内容已省略;完整数据请调用接口获取。
{
"DataStatus": {
"RequestParameter": "keywords=烽火&pagesize=10&pagenumber=1&type=&searchtype=all",
"StatusCode": 100,
"StatusDescription": "请求成功。",
"ResponseDateTime": "2026-10-28 22:22:34.771",
"DataTotalCount": 244
},
"Data": [
{
"Title": "贺新凉・贺新郎",
"Author": "吴泳",
"Content": [
"额扣龙墀苦。",
"对南宫、春风侍女,掉头不顾。",
"烽火连营家万里,漠漠黄沙吹雾。"
],
"Type": "宋词"
},
{
"Title": "水调歌头",
"Author": "吴渊",
"Content": [
"太白已仙去,诗骨此山藏。",
"胸中锦绣如屋,都乞与东皇。",
"碎翦杏花千树,浓抹胭脂万点,妖艳断人肠。"
],
"Type": "宋词"
},
{
"Title": "水调歌头",
"Author": "崔与之",
"Content": [
"万里云间戍,立马剑门关。",
"乱山极目无际,直北是长安。",
"人苦百年涂炭,鬼哭三边锋镝,天道久应还。"
],
"Type": "宋词"
}
]
}