唐诗宋词大全 API 接口

支持 40 万数据全文检索。

1. 产品功能

• 中文全数量级唐诗宋诗宋词数据；
• 关键字可对标题、作者与内容进行模糊匹配；
• 总计近 40 万条数据；
• 数据持续更新与维护；
• 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
• 全面兼容 Apple ATS；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡。

2. API 文档

API 详情地址: https://www.gugudata.com/api/details/chinesepoem

接口请求地址: https://api.gugudata.com/text/chinesepoem

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/text/chinesepoem?appkey=YOUR_APPKEY&keywords=YOUR_VALUE&pagesize=10&pagenumber=1&type=

数据预览: https://www.gugudata.com/preview/chinesepoem

接口测试: https://api.gugudata.com/text/chinesepoem/demo

3. 请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	YOUR_APPKEY	付费后获取的 APPKEY
keywords	string	否	YOUR_VALUE	查询关键字，注意：所有数据都是中文繁体，在传递关键词检索时，请注意传递中文繁体字进行查询
pagesize	int	是	10	分页参数，每页总条数，取值范围在 10 ~ 50 之间
pagenumber	int	是	1	分页参数，第几页
type	string	否		数据分类，可选参数为（tang, song, ci）。唐诗: tang \

4. 返回参数

参数名	参数类型	备注
DataStatus.StatusCode	int	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	int	此条件下的总数据量，一般用于分页计算
DataStatus.RequestParameter	string	请求参数，一般用于调试
Data.Title	string	诗歌标题或宋词词牌名
Data.Author	string	作者名
Data.Content	string[]	诗歌或词的内容，格式为 string 数组
Data.Type	string	类型，分为：唐诗 \

5. 接口 HTTP 响应标准状态码

状态码	状态码解释	备注
200	接口正常响应	业务状态码参见下方 接口自定义状态码
403	请求频率超限	CDN 层通过 IP 请求频率智能判断，一般的高频请求不会触发此状态码

6. 接口响应状态码

状态码	状态码解释	备注
100	正常返回	可通过判断此状态码断言接口正常返回
-1	请求失败	请求处理请求失败
501	参数错误	请检查您传递的参数个数以及参数类型是否匹配
502	请求频率受限	一般建议每秒请求不超过 100 次
503	APPKEY 权限超限/订单到期	请至开发者中心检查您的 APPKEY 是否到期或是否权限超限
504	APPKEY 错误	请检查传递的 APPKEY 是否为开发者中心获取到的值
505	请求的次数超出接口限制	请检查对应接口是否有请求次数限制以及您目前的接口请求剩余次数
900	接口内部响应错误	接口可用性为 99.999%，如获取到此状态码请邮件联系我们

7. 开发语言请求示例代码

示例代码包含的开发语言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等，其他语言进行对应的 RESTful API 请求实现即可。

8. 常见问题 Q&A

• Q: 数据请求有缓存吗？

A: 所有的数据都是直接返回的，部分周期性数据在更新周期内数据是缓存的。

• Q: 如何保证请求时 key 的安全性？

A: 一般建议将对我们 API 的请求放置在您应用的后端服务中发起，您应用的所有前端请求都应该指向您自己的后端服务，这样的架构也更加地纯粹且易维护。

• Q: 接口可以用于哪些开发语言？

A: 可以使用于所有可以进行网络请求的开发语言，用于您项目快速地进行数据构建。

• Q: 接口的性能可以保证吗？

A: 接口后台架构和我们给企业提供的商业项目架构一致，您可以通过访问测试接口查看接口相关返回性能与信息。

---

咕咕数据，专业的数据提供商，提供专业全面的数据接口、商业数据分析，让数据成为您的生产原料。

咕咕数据基于我们七年来为企业客户提供的千亿级数据存储与性能优化、相关海量基础数据支撑，将合规的部分通用数据、通用功能抽象成产品级数据 API，大大满足了用户在产品开发过程中对基础数据的需求，同时降低了海量数据的存储与运维成本，以及复杂功能的技术门槛与人力开发成本。

除了我们已开放的分类数据与功能接口外，还有海量数据正在整理、清洗、整合、构建中，后期会开放更多的数据与云端功能接口 API 供用户使用。

目前已开放的数据接口 API

• [条码工具] 通用二维码生成
• [条码工具] Wi-Fi 无线网二维码生成
• [条码工具] 通用条形码生成
• [图像识别] 通用 OCR
• [图像识别] 通用图片 OCR 到 Word
• [图像识别] HTML 转 PDF
• [图像识别] HTML 转 Word
• [图像识别] Markdown 转 PDF
• [区域/坐标] 全国大学高校基础信息
• [区域/坐标] 地理坐标逆编码
• [区域/坐标] IP 地址定位
• [区域/坐标] 全国省市区街道区域信息
• [区域/坐标] 地理坐标系转换
• [元数据/字典] 历年高考省录取分数线
• [元数据/字典] 历年高考高校录取分数线
• [元数据/字典] 历年高考专业录取分数线
• [新闻/资讯] 软件开发技术博文头条
• [新闻/资讯] 获取任意链接文章正文
• [新闻/资讯] 公众号头条文章
• [新闻/资讯] 获取任意链接正文图片
• [新闻/资讯] 获取公众号文章封面
• [新闻/资讯] 幽默笑话大全
• [短信/语音] 手机归属地查询
• [短信/语音] 国际手机号码检查纠正
• [文字/文本] 中文文本分词
• [文字/文本] 中英文排版规范化
• [文字/文本] 百万中国对联数据
• [文字/文本] 国际标准书号 ISBN
• [文字/文本] 简体繁体互转
• [文字/文本] 唐诗宋词大全
• [文字/文本] 关键字摘要智能提取
• [文字/文本] 文本语义相似度检测
• [文字/文本] NLP中文智能纠错
• [文字/文本] 人工智能对联生成
• [文字/文本] NLP 语种检测
• [天气/空气质量] 全国天气预报信息
• [天气/空气质量] 全国实时空气质量指数
• [天气/空气质量] 日出与日落时间
• [天气/空气质量] 农历与二十四节气
• [网站工具] 获取任意站点标题与图标
• [股票行情] 美股实时行情数据
• [股票行情] 美股历史行情数据
• [股票行情] 美股分时交易数据
• [股票行情] 美股历年基本财务数据
• [股票行情] 港股实时行情数据
• [股票行情] 港股历史行情数据
• [股票行情] 港股分时交易数据
• [股票行情] 港股上市公司公告
• [股票行情] 港股历年三大财务报表
• [股票行情] A 股实时行情数据
• [股票行情] A 股历史行情数据
• [股票行情] A 股分时交易数据
• [股票行情] A 股历年三大财务报表
• [股票行情] 中国股票指数数据
• [股票行情] A 股个股信息查询
• [股票行情] A 股历年财务指标
• [股票行情] A 股指数成分数据
• [股票行情] A 股指数历史数据
• [股票行情] A 股盘前数据
• [股票行情] A 股分笔交易数据
• [股票行情] A 股交易日历
• [股票行情] 期权实时行情数据
• [股票行情] 基金基本信息列表
• [股票行情] 指数型基金基本信息
• [股票行情] 开放式基金净值实时数据
• [股票行情] 开放式基金净值历史数据
• [股票行情] 科创板历史行情数据
• [股票行情] 美股粉单实时行情数据
• [股票行情] 分类美股实时行情数据
• [股票行情] 公募开放式基金实时数据
• [股票行情] 公募开放式基金历史数据
• [股票行情] 场内交易基金实时数据
• [股票行情] 场内交易基金历史数据
• [股票行情] 场内交易基金分时行情
• [体育/比赛] 历年奥运比赛数据)