第三方文章概览查询接口
更新时间：2026-03-20 11:10:36
API测试
申请API调用
基本信息
接口描述：查询文章数据的服务接口，支持稿件基本属性及关键词的查询。
请求方式：post
请求地址：
gonggao/base/doc/search
请求参数格式：application/x-www-form-urlencoded
输入参数
参数名称
类型
是否必填
描述
startPubTime
string
是
文章发布时间，表示查询这个时间之后的文章，格式yyyyMMdd或yyyyMMddHHmmss
endPubTime
string
是
文章发布时间，表示查询这个时间之前的文章，格式yyyyMMdd或yyyyMMddHHmmss
startLoadTime
string
否
文章入库时间，如果输入了则查询这个时间之后入库的文章，用于增量数据同步的场景，格式yyyyMMdd或yyyyMMddHHmmss
endLoadTime
string
否
文章入库时间，如果输入了则查询这个时间之前入库的文章，用于增量数据同步的场景，格式yyyyMMdd或yyyyMMddHHmmss
startUpdateTime
string
否
文章更新时间，如果输入了则查询这个时间之后更新的文章，格式yyyyMMdd或yyyyMMddHHmmss
endUpdateTime
string
否
文章更新时间，如果输入了则查询这个时间之前更新的文章，格式yyyyMMdd或yyyyMMddHHmmss
searchWord
string
否
搜索的关键字，标题或正文中任何一个字段匹配成功都会返回结果，多个关键字使用“,”分隔或使用“;”分隔，多个关键字必须同时包含才会返回，输入的关键词总长度100个字符以内。注意关键词不能包含{、}、“ 等特殊字符
title
string
否
标题搜索的关键词，只查询标题字段，参数说明和查询逻辑同searchWord
content
string
否
正文搜索的关键词，只查询正文字段，参数说明和查询逻辑同searchWord
siteName
string
否
站点名称，多个名称使用“,”分隔或使用“;”分隔。参数限制：多个参数时数量不超过10个；参数值总长度50个字符以内
mediaUnitName
string
否
微信所属的集团名称，多个集团名称使用“,”分隔或使用“;”分隔。参数限制：多个参数时数量不超过10个；参数值总长度50个字符以内
mediaType
string
否
媒体类型，示例：官方媒体、商业媒体等，更多分类见数据字典
mediaLevel
string
否
媒体等级：核心、一级、二级
mediaAdministrationType
string
否
媒体行政属性，示例：央媒、中央行业媒体、省级媒体、市级媒体、区县级媒体等，更多分类和说明见数据字典
mediaIndustryCatalog
string
否
媒体所属的垂直行业类型：体育、教育、财经等，具体行业类型见数据字典
mediaAreaCatalog
string
否
媒体所属地域：北京_大兴区；安徽_合肥等，具体地域名称见数据字典
contentAreaCatalog
string
否
文章内容报道地域：查询内容报道某一地域的文章：北京_大兴区；安徽_合肥等，具体地域名称见数据字典
contentIndustryCatalog
string
否
文章内容报道的行业分类，示例：体育、教育、财经等，更多分类见数据字典
pageNum
string
否
返回结果集页码，首页及默认值均为0
pageSize
string
否
每页返回结果集数量，默认值20，最大值不可超过100
sortOrder
string
否
结果集排序方式，通过“+”、“-”和数据字段来控制正序或倒序，示例-pubTime表示按照文章发布时间倒叙，支持多字段一起排序，比如【-loadTime,+pubTime】表示先根据入库时间倒序排列，如果时间一致时在根据发布时间正序排序。接口支持的排序字段如下：pubTime(文章发布时间)、loadTime(文章入库时间)、updateTime(文章更新时间)、relevance(相关度，只有输入检索词时此参数才有意义，相关度只支持倒序，不支持正序)、readCount(阅读数)、commentCount(评论数)
输出参数
参数名称
类型
描述
code
string
接口状态码，200为正常，其他为错误码
msg
string
接口的错误描述信息
errorMsg
string
出现错误时的详细描述，方便开发人员排重问题
requestid
string
当前请求的唯一ID，反馈问题时直接提交此信息
data
object
接口内的具体返回信息
docid
string
文章id，唯一值，查询详情时使用
sid
string
文章id，唯一值，查询传播服务时使用这个id
urlKey
string
通过url计算的key，常用于采集互动等服务
title
string
稿件标题
siteName
string
站点名称
uid
string
账号id
pubTime
string
发布时间，格式yyyy-MM-dd HH:mm:ss
keywords
string
抽取的关键词
url
string
文章链接
mediaUnitName
string
集团名称
loadTime
string
入库时间，格式yyyy-MM-dd HH:mm:ss
abstracts
string
摘要
pictureUrls
string
文章正文中的片连接地址
readCount
string
阅读数
commentCount
string
评论数
source
string
稿件来源
调用示例
http://[域名]/opens/api/gonggao/base/doc/search?
输入示例
medium=baijia&startPubTime=20240401&endPubTime=20240308
输出示例
{
"code": 200,
"msg": "请求成功",
"data": {
"content": [
{
"readCount": "4275",
"uid": "",
"docid": "408857_8754446203581429454_0",
"sid": "2716145345230648524",
"urlKey": "8754446203581429454",
"title": "追凶20年！",
"siteName": "宁波公安",
"pubTime": "2024-03-28 18:02:00",
"source": "",
"keywords": "犯罪嫌疑人;慈溪;樊某;公安;公安局刑侦;案件;相关线索;命案积案;刑侦民警;专题会议",
"url": "https://baijiahao.baidu.com/s?id=1794763793391028120",
"mediaUnitName": "",
"loadTime": "2024-03-29 16:11:56",
"abstracts": "也至此正式告破!核发|严挺。",
"pictureUrls": "https://pics7.baidu.com/feed/e4dde71190ef76c6a132ceda221e3bf7ae516770.jpeg@f_auto"
},
{
"readCount": "257",
"uid": "",
"docid": "408857_14506525096571592661_0",
"sid": "17657919141434760769",
"urlKey": "14506525096571592661",
"title": "极寒环境如鱼得水 冰雪试驾中国重汽皮卡越野型",
"siteName": "皮卡网",
"pubTime": "2024-03-20 09:07:00",
"source": "",
"keywords": "越野;冰雪;冰雪路面;车型;地形;雪地;配备;黑河;越野挑战赛;变速箱",
"url": "https://baijiahao.baidu.com/s?id=1793226387027878386",
"mediaUnitName": "人民日报社",
"loadTime": "2024-03-20 10:08:34",
"abstracts": "雪域驾趣,性能为王, 2024(第二届)皮卡冰雪驾控体验营暨寒区越野挑战赛已经于3月3日圆满落幕。在这次冰雪活动中,很多企业都派出了旗下的当家车型前来参与,展示皮卡在冰雪极寒环境下的表现。其中有一款车型非常值得关注,那就是中国重汽皮卡越野型,因为此前很少有媒体能够在这种环境下试驾这台原厂车型,所以它在冰雪路面上的表现很值得期待。",
"pictureUrls": "https://pics2.baidu.com/feed/ac4bd11373f082029bdf44b4d8ba40e0aa641bbf.jpeg@f_auto"
}
],
"totalElements": 297563,
"totalPages": 2976,
"number": 0,
"size": 100,
"numberOfElements": 100
},
"requestid": "7dc965b4-d3cc-4e4a-b760-28469e3617cf",
"errorMsg": null
}
接口说明
无
在线测试
请求方式：
POST
*medium：
*startPubTime：
*endPubTime：
startLoadTime：
endLoadTime：
startUpdateTime：
endUpdateTime：
searchWord：
title：
content：
siteName：
mediaUnitName：
mediaType：
mediaLevel：
mediaAdministrationType：
mediaIndustryCatalog：
mediaAreaCatalog：
contentAreaCatalog：
contentIndustryCatalog：
pageNum：
pageSize：
sortOrder：
确定
重置
请求结果
错误码
其他错误码详见
公共错误码。