API-V5 接口说明-炫知系统接口
炫知系统接口
2.1 炫知-媒体发稿量
POST https://api.hylanda.com/v5/xuanzhi/media/publish_count
测试地址:https://api.hylanda.com/v5/help/util/try/#!/xuanzhi/XZ_Media_Publish_Count
接口描述
- 查询媒体在某天的发稿量
- 请注意:日期应在30日内
接口参数
海量APIv5接口参数统一使用POST JSON 方式传递
| 参数名 | 位置 | 类型 | 描述 | 默认值 |
|---|---|---|---|---|
| hl_appkey 必需 |
HEADERS | string | 鉴权用,海量分配的appkey,参考《通用接口标准》 | |
| hl_time 必需 |
HEADERS | string | 鉴权用,当前时间,参考《通用接口标准》 | |
| hl_sign 必需 |
HEADERS | string | 鉴权用,签名校验码,参考《通用接口标准》 | |
| date 必需 |
BODY-JSON | string | 获取哪天的发稿量 | 无 |
| name 必需 |
BODY-JSON | string | 获取哪个媒体的发稿量 | 无 |
| type 必需 |
BODY-JSON | enum | 获取发稿量的类型,一般使用standard_media_name,其他详见说明 | 无 |
BODY-JSON样例
{
"date":"2021-11-06",
"name":"新华网",
"type":"standard_media_name"
}
其他参数细节
| type 参数可选项 | 说明 |
|---|---|
| standard_media_name | 使用标准化后的媒体名称查询 |
| media_name | 使用未标准化的媒体名称查询 |
正常响应的返回数据
{
'res': 0, //正常返回均为0
'msg': '请求成功',
'data': { //data字段内为JsonObject,内部为查询结果
'date': '2021-11-06',
'name': '新华网',
'type': 'standard_media_name',
'publish_count': 2532 //查询到新华网媒体在2021年11月6日的发稿量为2532
}
}
错误返回信息说明
通用错误信息,请参考《通用接口标准》
下面为本服务特有的错误反馈说明
| HTTP Code | HTTP Response Body | Description |
|---|---|---|
| 200 | { "res": -1, "msg": "具体错误信息" } |
2.2 炫知-新闻传播分析数据
POST https://api.hylanda.com/v5/xuanzhi/analysis/news
POST https://api.hylanda.com/v5/xuanzhi/analysis_plus/news (高级版)
测试地址:https://api.hylanda.com/v5/help/util/try/#!/xuanzhi/XZ_Analysis_News
接口描述
- 根据新闻的url查询新闻传播分析数据
接口参数
海量APIv5接口参数统一使用POST JSON 方式传递
| 参数名 | 位置 | 类型 | 描述 | 默认值 |
|---|---|---|---|---|
| hl_appkey 必需 |
HEADERS | string | 鉴权用,海量分配的appkey,参考《通用接口标准》 | |
| hl_time 必需 |
HEADERS | string | 鉴权用,当前时间,参考《通用接口标准》 | |
| hl_sign 必需 |
HEADERS | string | 鉴权用,签名校验码,参考《通用接口标准》 | |
| url 必需 |
BODY-JSON | string | 新闻的url |
BODY-JSON样例
{
"url":"https://news.sina.com.cn/gov/2021-12-03/doc-ikyakumx1800581.shtml"
}
其他参数细节
暂无
正常响应的返回数据
{
"res": 0,
"msg": "请求成功",
"data": {
"news_list": [{
"area": "兰州",
"site_type": "省级网站",
"standard_content_media_name": "人民网",
"release_date": "2021-12-03 16:36:18",
"author": "俞懿春、姜波、姜宣、",
"media_name": "每日甘肃网",
"title": "国际人士积极评价中国共产党坚持与时俱进",
"content_media_name": "人民网",
"url": "http://china.gansudaily.com.cn/system/2021/12/03/030454514.shtml",
"standard_media_name": "每日甘肃网"
}...],
"desc"(高级版): {
"release_date": "2021-12-03 05:08:00",
"reship_count": 69,
"spanfmt": "11小时35分",
"tp_count": 137,
"peak_list": [{
"peakend": "2021-12-03 16:36:18",
"peakstart": "2021-12-03 11:00:59",
"count": 82
}...],
"tpv": 2410,
"title": "国际人士积极评价中国共产党坚持与时俱进",
"reship_list": [{
"count": 78,
"media_name": "人民网"
}...],
"peak_count": 6
}
}
}
错误返回信息说明
通用错误信息,请参考《通用接口标准》
下面为本服务特有的错误反馈说明
| HTTP Code | HTTP Response Body | Description |
|---|---|---|
| 200 | { "res": -1, "msg": "具体错误信息" } |
2.3 炫知-事件传播力分析数据
POST https://api.hylanda.com/v5/xuanzhi/analysis/keywords
POST https://api.hylanda.com/v5/xuanzhi/analysis_plus/keywords(高级版)
测试地址:https://api.hylanda.com/v5/help/util/try/#!/xuanzhi/XZ_Analysis_Keywords
接口描述
- 根据事件的关键词查询事件传播数据
接口参数
海量APIv5接口参数统一使用POST JSON 方式传递
| 参数名 | 位置 | 类型 | 描述 | 默认值 |
|---|---|---|---|---|
| hl_appkey 必需 |
HEADERS | string | 鉴权用,海量分配的appkey,参考《通用接口标准》 | |
| hl_time 必需 |
HEADERS | string | 鉴权用,当前时间,参考《通用接口标准》 | |
| hl_sign 必需 |
HEADERS | string | 鉴权用,签名校验码,参考《通用接口标准》 | |
| keywords 必需 |
BODY-JSON | string | 事件关键词 | 最多20个字 |
BODY-JSON样例
{
"keywords":"坚持与时俱进"
}
其他参数细节
暂无
正常响应的返回数据
{
"res": 0,
"msg": "请求成功",
"data": {
"news_list": [{
"release_date": "2021-12-03 09:55:41",
"repeat_count": 1,
"title": "国际人士积极评价中国共产党坚持与时俱进",
"url": "https://view.inews.qq.com/a/20211203A02H0H00",
"standard_media_name": "腾讯网",
"repeat_list": [{
"area": "广州",
"site_type": "重点门户商业网站",
"standard_content_media_name": "国际万花筒",
"release_date": "2021-12-03 09:55:41",
"author": "",
"media_name": "腾讯新闻",
"title": "国际人士积极评价中国共产党坚持与时俱进",
"url": "https://view.inews.qq.com/a/20211203A02H0H00",
"standard_media_name": "腾讯网",
"content_media_name": "国际万花筒"
}]
}...],
"desc"(高级版): {
"sp_score": 2845,
"first_news": "毫不动摇坚持.与时俱进完善人民代表大会制度",
"span_time": "23天8小时",
"first_release_date": "2021-11-10 07:50:00",
"site_count": 83,
"tp_count": 177,
"most_count": 134,
"data_count": 20,
"most_news": "国际人士积极评价中国共产党坚持与时俱进"
}
}
}
错误返回信息说明
通用错误信息,请参考《通用接口标准》
下面为本服务特有的错误反馈说明
| HTTP Code | HTTP Response Body | Description |
|---|---|---|
| 200 | { "res": -1, "msg": "具体错误信息" } |
2.4 炫知-发稿量、原创量和监测量
POST https://api.hylanda.com/v5/xuanzhi/analysis/profile
测试地址:https://api.hylanda.com/v5/help/util/try/#!/xuanzhi/XZ_Analysis_Profile
接口描述
- 查询全网检测中,互联网发稿量、互联网原创总量和网站监测总量
接口参数
海量APIv5接口参数统一使用POST JSON 方式传递
| 参数名 | 位置 | 类型 | 描述 | 默认值 |
|---|---|---|---|---|
| hl_appkey 必需 |
HEADERS | string | 鉴权用,海量分配的appkey,参考《通用接口标准》 | |
| hl_time 必需 |
HEADERS | string | 鉴权用,当前时间,参考《通用接口标准》 | |
| hl_sign 必需 |
HEADERS | string | 鉴权用,签名校验码,参考《通用接口标准》 | |
| type 必需 |
BODY-JSON | string | 查询类型 | 该接口传"tp" |
BODY-JSON样例
{
"type":"tp"
}
其他参数细节
暂无
正常响应的返回数据
{
"res": 0,
"msg": "请求成功",
"data": {
"tp_original_count": 148863, 原创总量
"tp_count": 928297, 发稿量
"tp_site_count": 23866 网站监测总量
}
}
错误返回信息说明
通用错误信息,请参考《通用接口标准》
下面为本服务特有的错误反馈说明
| HTTP Code | HTTP Response Body | Description |
|---|---|---|
| 200 | { "res": -1, "msg": "具体错误信息" } |
2.5 炫知-资讯传播力排行榜
POST https://api.hylanda.com/v5/xuanzhi/top/tpv
测试地址:https://api.hylanda.com/v5/help/util/try/#!/xuanzhi/XZ_Top_Tpv
接口描述
- 查询资讯传播力排行榜
接口参数
海量APIv5接口参数统一使用POST JSON 方式传递
| 参数名 | 位置 | 类型 | 描述 | 默认值 |
|---|---|---|---|---|
| hl_appkey 必需 |
HEADERS | string | 鉴权用,海量分配的appkey,参考《通用接口标准》 | |
| hl_time 必需 |
HEADERS | string | 鉴权用,当前时间,参考《通用接口标准》 | |
| hl_sign 必需 |
HEADERS | string | 鉴权用,签名校验码,参考《通用接口标准》 | |
| zone 必需 |
BODY-JSON | string | 区域代码 | |
| original 必需 |
BODY-JSON | string | 0非原创,1原创 | |
| type 必需 |
BODY-JSON | string | 查询类型, 100(互联网传播力排行榜), 101(区域原创), 102(近30分钟), 300(中央级媒体传播力排行榜), 400(省级媒体传播力排行榜), 500(商业媒体传播力排行榜) |
BODY-JSON样例
{
"zone":"0",
"original":"0",
"type":"100"
}
其他参数细节
暂无
正常响应的返回数据
{
"res": 0,
"msg": "请求成功",
"data": {
"news_list": [{
"release_date": "2021-12-09 16:26:00",
"name": "爱回收.豆瓣.唱吧等106款App被工信部下架",
"tpv": 2159,
"media_name": "新浪网",
"url": "http://k.sina.com.cn/article_5044281310_12ca99fde02001px4e.html"
},
{
"release_date": "2021-12-09 17:00:00",
"name": "我国\"刑事缺席审判第一案\"程三昌贪污案一审开庭",
"tpv": 1937,
"media_name": "新浪网",
"url": "http://k.sina.com.cn/article_2010666107_77d8547b020014vlv.html"
}...]
}
}
错误返回信息说明
通用错误信息,请参考《通用接口标准》
下面为本服务特有的错误反馈说明
| HTTP Code | HTTP Response Body | Description |
|---|---|---|
| 200 | { "res": -1, "msg": "具体错误信息" } |