全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件

API 参考

更新时间:2017-08-02 19:07:07

一、通用说明

API的调用格式形如:https://shujuapi.aliyun.com/dataplus_001/prophet/queryTopicsList?param1=ab&param2=cd

所有的返回结果中,都会附带以下系统级返回参数,用于判断接口调用是否出错及相应的出错信息。

系统级返回字段说明

参数名 参数类型 说明
success boolean 接口处理是否成功的标识
errorCode int 如果出错,表示出错状态码
other string 额外提示信息
msgCode int 提示信息状态码
msgInfo string 提示信息
messages array[string] 如果出错,表示出错信息。如果成功,也可能为成功的提示信息
result json 该对象封装了业务对象实体。如果success为true时,此对象才有值。 具体参数见各接口中说明

二、关键字专题接口

1、查询关键字专题

API功能:查询一个业务方的所有关键字专题列表,或者根据名称模糊匹配关键字专题列表。

接口名称:queryTopicsList

方法:GET

入参说明

参数名 参数类型 是否必填 说明
status int 状态。0:未启用 1:启用。 为null,表示查询所有关键字专题列表

返回示例

  1. {
  2. "success":true,
  3. "errorCode":null,
  4. "other":null,
  5. "msgCode":null,
  6. "msgInfo":null,
  7. "messages":[],
  8. "result":[{
  9. "id":6542,
  10. "name":"测试",
  11. "status":0,
  12. "createdAt":"2016-04-28T02:01:49.000Z",
  13. "updatedAt":"2016-04-28T02:12:13.000Z"
  14. }]
  15. }

返回参数说明

参数名 参数类型 说明
id int 关键字专题主键ID
name string 关键字专题名称
status int 关键字专题状态。0:未启用 1:启用
createdAt Date 创建时间。时间格式为UTC时间
updatedAt Date 更新时间。时间格式为UTC时间

2、创建关键字专题

API功能:用于创建一个新的关键字专题。

接口名称:createTopic

方法:POST

入参说明

参数名 参数类型 是否必填 说明
name string 关键字专题名称
status int 状态。0:未启用 1:启用 默认值:1

返回示例

  1. {
  2. "success":true,
  3. "errorCode":null,
  4. "other":null,
  5. "msgCode":null,
  6. "msgInfo":null,
  7. "messages":[],
  8. "result":6543 //成功创建的关键字专题主键id
  9. }

3、更新关键字专题

API功能:对现有关键字专题的更新操作,可对关键字专题名称、是否开启监控状态这两个属性进行修改。

接口名称:updateTopic

方法:POST

参数:

入参说明

参数名 参数类型 是否必填 说明
id int 关键字专题主键ID
name string 关键字专题名称
status int 状态。0:未启用 1:启用

返回示例

  1. {
  2. "success":true,
  3. "errorCode":null,
  4. "other":null,
  5. "msgCode":null,
  6. "msgInfo":null,
  7. "messages":[],
  8. "result":6543 //关键字专题主键id
  9. }

4、删除关键字专题

API功能:逻辑删除一个关键字专题。非物理删除,如果不小心物理删除,请提工单进行修正。

接口名称:deleteTopic

方法:POST

参数:

入参说明

参数名 参数类型 是否必填 说明
id int 关键字专题主键ID

返回示例

  1. {
  2. "success":true,
  3. "errorCode":null,
  4. "other":null,
  5. "msgCode":null,
  6. "msgInfo":null,
  7. "messages":[],
  8. "result":6543 //成功删除的关键字专题主键id
  9. }

5、开启/关闭关键字专题

API功能:对现有关键字专题开启或者关闭

接口名称:turnTopic

方法:POST

入参说明

参数名 参数类型 是否必填 说明
id int 关键字专题主键ID
status int 状态。0:未启用 1:启用

返回示例

{ “success”: true, “errorCode”: null, “other”: null, “msgCode”: null, “msgInfo”: null, “messages”: [ ], “errorMessages”: [ ], “result”: 6909 // 成功开启/关闭的关键字专题主键id }

三、源站类型

1、查询源站类型列表

API功能:该接口用于在添加关键字时,选择关联的源站类型。

请注意:源站类型的ID只用作添加/编辑关键字时使用,不可用于舆情查询接口。关键字创建后,关键字会关联到一个新的站点组ID(spiderTopicId)。此ID才可用于查询舆情时使用

接口名称:getSystemSiteTypes

方法:GET

入参说明

参数名 参数类型 是否必填 说明
name string 模糊匹配源
langType string 语言类型标识。默认为ch
  • 语言类型映射表:
标识 语言
fr 法语
es 西班牙语
de 德语
it 意大利语
pt 葡萄牙语
ru 俄语
jp 日语
ko 韩语
ar 阿拉伯语
nl 荷兰语
ch 中文
en 英语
vi 越南语
th 泰语
tr 土耳其语
he 希伯来语
id 印尼语
pl 波兰语
hi 印地语

返回示例

  1. {
  2. "success":true,
  3. "errorCode":null,
  4. "other":null,
  5. "msgCode":null,
  6. "msgInfo":null,
  7. "messages":[],
  8. "result":[
  9. {"id":8,"name":"新闻","langType":"ch"},
  10. {"id":9,"name":"微博","langType":"ch"},
  11. ....
  12. ]
  13. }

返回参数说明

参数名 参数类型 说明
id int 源站类型主键ID
name string 源站类型名称
langType string 源站类型语言

四、关键字接口

1、查询关键字

API功能:分页查询一个关键字专题下面的所有已经添加的关键字。

接口名称:getKeywords

方法:GET

入参说明

参数名 参数类型 是否必填 说明
topicId int 关键字专题ID
toPage int 用于分页查询。当前页码,默认值为:1
pageSize int 用于分页查询。每页显示条数。默认值为:20。

返回示例

  1. {
  2. "pageSize":20, // 每页显示多少
  3. "toPage":1, // 当前页码
  4. "totalCount":1, // 一共多少条
  5. "totalPages":1, // 一共多少页
  6. "success":true,
  7. "errorCode":null,
  8. "other":null,
  9. "msgCode":null,
  10. "msgInfo":null,
  11. "messages":[],
  12. "result":[{
  13. "id":12362, //关键字ID
  14. "keyword":"杭州 交通事故", //关键字内容
  15. "topicId":6544, //关键字专题ID
  16. "createdAt":"2016-04-28T03:09:12.000Z",
  17. "updatedAt":"2016-04-28T03:09:12.000Z",
  18. "spiderTopics":[{
  19. "id":2252, //站点组ID,用于舆情搜索时,指定的spiderTopicId
  20. "name":"新闻" //站点组名称
  21. },{
  22. "id":2253,
  23. "name":"微博"
  24. }]
  25. }]
  26. }

2、添加关键字

API功能:用于向一个关键字专题添加关键字。一个关键字组合内部可用空格表示“AND”的关系,可一次性添加多个关键字组合。

接口名称:createKeyword

方法:POST

入参说明

参数名 参数类型 是否必填 说明
topicId int 关键字专题ID
keywords string/array 关键字,多个关键字请用json数组封装,如 [“关键字1”,”关键字2”]
siteTypeIds int/array 关联的源站类型ID,多个请用json数组封装,如 [8,9]

返回示例

  1. {
  2. "success":true,
  3. "errorCode":null
  4. "other":null,
  5. "msgCode":null,
  6. "msgInfo":null,
  7. "messages":[],
  8. "result":[12363,12364] // 创建成功的关键字ID数组
  9. }

3、删除关键字

API功能:逻辑删除关键字。删除后,系统将在约20分钟内生效;20分钟后,便不会再抓取该词,但是历史抓取记录会被保留。

接口名称:deleteKeyword

方法:POST

入参说明

参数名 参数类型 是否必填 说明
ids int/array 要删除的关键字ID。如果是多个,请用json数组封装,如 [12363,12364]

返回示例

  1. {
  2. "success":true,
  3. "errorCode":null
  4. "other":null,
  5. "msgCode":null,
  6. "msgInfo":null,
  7. "messages":[],
  8. "result":[12363,12364] // 删除成功的关键字id数组
  9. }

4、编辑关键字(单个)

API功能:用于修改单个关键字的属性。支持对内容、所属关键字专题、抓取的源站类型3个属性的修改。

接口名称:updateKeyword

方法:POST

入参说明

参数名 参数类型 是否必填 说明
id int 关键字主键ID
keyword string 关键字内容
topicId int 关键字专题ID
siteTypeIds int/array 关联的源站类型主键ID,多个请用json数组封装,如 [2232,2233]

返回示例

  1. {
  2. "success":true,
  3. "errorCode":null
  4. "other":null,
  5. "msgCode":null,
  6. "msgInfo":null,
  7. "messages":[],
  8. "result":[12363] // 更新成功的关键字主键ID
  9. }

5、编辑关键字(批量)

API功能:用于修改多个关键字的属性。支持对所属关键字专题、抓取的源站类型两个属性的修改。

接口名称:updateKeywords

方法:POST

入参说明

参数名 参数类型 是否必填 说明
ids int/array 关键字主键ID,多个可用json数组封装,如 [12363,12364]
topicId int 关键字专题ID
siteTypeIds int/array 关联的源站类型主键ID,多个请用json数组封装,如 [2232,2233]

返回示例

  1. {
  2. "success":true,
  3. "errorCode":null
  4. "other":null,
  5. "msgCode":null,
  6. "msgInfo":null,
  7. "messages":[],
  8. "result":[12369,12370] // 更新成功的关键字主键ID列表
  9. }

五、舆情数据

1、搜索舆情数据

API功能:用于对抓取数据的同步搜索。注意:该接口仅在数据抓取到后,才可搜索,而非实时从互联网中抓取,并且目前默认按发布时间排序。

接口名称:search

方法:GET

入参说明

参数名 参数类型 是否必填 说明
subject string 模糊匹配标题内容
description string 模糊匹配全文(标题+正文)
from string 源站名称,如:新浪网、百度贴吧、微博名
spiderTopicId int 站点组ID。请参考:getKeywords中返回的spiderTopics的ID属性
hotEvent string 热门事件名称。请参考:facetSearch中设置facetType=hot_event,返回的name属性
keyword string 关键词名称。请参考:facetSearch中设置facetType=keyword,返回的name属性
site string 媒体名称。请参考:facetSearch中设置facetType=site,返回的name属性
monitorTopicId int 关键字专题。请参考:getKeywords中返回的topicId属性
emotionTendencys int 情感趋势,1 正面,0 中性,-1 负面。
clusterId int 查询相似的舆情数据。一个cluster表示一批相似数据,同一批相似舆情的clusterId为同一个,clusterId为中心点舆情的主键。
createdAtBegin date 抓取开始时间(>=),格式 2016-04-28 13:30:41
createdAtEnd date 抓取结束时间(<=),格式 2016-04-28 13:30:41
pubTimeBegin date 舆情发布时间(>=),格式 2016-04-28 13:30:41
pubTimeEnd date 舆情结束时间(<=),格式 2016-04-28 13:30:41
clusterFlag int 合并相似:0:为合并相似状态,1:非合并状态,默认1
tab int 舆情列表类别:0:为全部舆情,1:有效舆情,2:新舆情
toPage int 用于分页查询。当前页码,不传默认值:1
pageSize int 用于分页查询。每页显示条数。默认值为:20。

返回示例

  1. {
  2. "pageSize":20,
  3. "toPage":20,
  4. "totalCount":0,
  5. "totalPages":0,
  6. "success":true,
  7. "errorCode":null,
  8. "other":null,
  9. "msgCode":null,
  10. "msgInfo":null,
  11. "messages":[],
  12. "result":{
  13. "records":[{
  14. "id":11175897,
  15. "monitorKeywords":"*",
  16. "monitorKeywordId":12359,
  17. "monitorTopicId":0,
  18. "subject":"《疯狂动物城》尼克狐的.....",
  19. "translateSubject":null,
  20. "translateDescription":null,
  21. "description":"*文章为作者独立观点,不代表虎嗅网立。。。。",
  22. "clusterId":11175897,
  23. "priority":4,
  24. "url":"http://www.huxiu.com/article/147005/1.html?f=index_feed_article",
  25. "createdAt":"2016-04-28T04:53:05.000Z",
  26. "pubTime":"2016-04-28T04:51:04.000Z",
  27. "from":"虎嗅网",
  28. "langType":"ch",
  29. "filterStatus":1,
  30. "wbType":2,
  31. "wbFansCount":0,
  32. "wbRepostCount":0,
  33. "wbCommentCount":0,
  34. "wbLikeCount":null,
  35. "wbVerifiedType":0,
  36. "emotionTendency":-1,
  37. "emotionScore":-7
  38. }],
  39. "facetFields":null,
  40. "dateFacetFields":null
  41. }
  42. }

返回参数说明

参数名 参数类型 说明
id int 舆情对象主键
productId int 先知的产品编号
spiderTopicId int 站点组ID:与源站类型是一一对应的。
monitorKeywordId int 舆情抓取的关键字ID
monitorKeywords string 舆情抓取的关键字内容
monitorTopicId int 关键字专题ID
from string 网站名/微博作者/微信公众号
url string 舆情链接。对应新闻URL/微博URL/微信公众号文章URL等
filterStatus int 0:待确认舆情,1:有效舆情 2:被过滤的舆情(放垃圾箱)
createdAt date 抓取时间
pubTime date 新闻/微博发布的时间(如果只获取到天,时分秒都为0)
wbId int 微博的主键ID
wbUserId int 微博用户的主键ID
wbFansCount int 微博粉丝数。可能在数据量大的情况下此值为空.
wbRepostCount int 微博转发数。原创微博抓取瞬间几乎都为0,如果为转发微博,建议开发者更新被转发微博的转发次数
wbCommentCount int 微博评论数。原创微博抓取瞬间几乎都为0,如果为转发微博,建议开发者更新被转发微博的评论次数
wbLikeCount int 微博点赞数。原创微博抓取瞬间几乎都为0,如果为转发微博,建议开发者更新被转发微博的点赞次数
wbVerifiedType int 微博用户认证类型 0-普通,1-个人认证,2-企业认证,3-微博达人。可能在数据量大的情况下此值为空。
wbType int 微博类型:0为原创微博,1为转发微博,2为微博评论
emotionTendency int 情感极性0中性 1正面 -1负面
emotionScore int 情感分数,绝对值越大,表示对应的情感越强烈
urlMD5 string url的md5哈希值
tags string 自动打上的标签,多个会用竖线进行分隔。
langType string 语言类型。如ch表示中文,en表示英文
subject string 文章标题。如果是微博,则为微博内容的摘要。
description string 正文摘要(100字以内)。如果是微博,则为微博内容的前100个字符
translateSubject string 如果是非中文和英文,翻译成英文之后的标题
translateDescription string 如果是非中文和英文,翻译成英文之后的详情
clusterId int 相似舆情的中心结点主键,在search接口传入此参数可查询与该条舆情相似的其他舆情数据
priority int 优先级,1到4表示P1到P4
similarCount int 相似数

2、将某舆情标示为有效

API功能:此接口将舆情标记为有效舆情,用于将用户操作的数据进行回流,以方便系统进行智能过滤。

接口名称:setIsValid

方法:POST

入参说明

参数名 参数类型 是否必填 说明
id Long 舆情主键ID
flag int 有效状态。1:有效,0:无效(舆情在抓取时,默认就是无效,标记为0只用作取消错误标记为有效的舆情)

返回示例

  1. {
  2. "success":true,
  3. "errorCode":null
  4. "other":null,
  5. "msgCode":null,
  6. "msgInfo":null,
  7. "messages":[],
  8. "result":[11179498] // 更新成功的舆情主键ID
  9. }

3、热点事件、关键字、媒体、关键字专题展示

API功能:用于展示热点事件、关键字、媒体、关键字专题。注意:该接口拥有search接口的搜索过滤功能,可以通过填写搜索条件达到效果。

接口名称:facetSearch

方法:GET

入参说明

参数名 参数类型 是否必填 说明
subject string 模糊匹配标题内容
description string 模糊匹配全文(标题+正文)
from string 源站名称,如:新浪网、百度贴吧、微博名
spiderTopicId int 站点组ID。请参考:getKeywords中返回的spiderTopics的ID属性
hotEvent string 热门事件名称。请参考:facetSearch中设置facetType=hot_event,返回的name属性
keyword string 关键词名称。请参考:facetSearch中设置facetType=keyword,返回的name属性
site string 媒体名称。请参考:facetSearch中设置facetType=site,返回的name属性
monitorTopicId int 关键字专题ID。请参考:getKeywords中返回的topicId属性
emotionTendencys int 情感趋势,1 正面,0 中性,-1 负面。
clusterId int 查询相似的舆情数据。一个cluster表示一批相似数据,同一批相似舆情的clusterId为同一个,clusterId为中心点舆情的主键。
createdAtBegin date 抓取开始时间(>=),格式 2016-04-28 13:30:41
createdAtEnd date 抓取结束时间(<=),格式 2016-04-28 13:30:41
pubTimeBegin date 舆情发布时间(>=),格式 2016-04-28 13:30:41
pubTimeEnd date 舆情结束时间(<=),格式 2016-04-28 13:30:41
clusterFlag int 合并相似:0:为合并相似状态,1:非合并状态,默认1
tab int 舆情列表类别:0:为全部舆情,1:有效舆情,2:新舆情
facetType string 分组展示类型:hot_event:热门事件,keyword:关键字,site:媒体,monitor_topic:关键字专题
toPage int 用于分页查询。当前页码,不传默认值:1
pageSize int 用于分页查询。每页显示条数。默认值为:20。

返回示例

  1. {
  2. "success": true,
  3. "data": [
  4. {
  5. "name": "微信", //注意,facetType=monitor_topic,返回的name为关键字专题ID
  6. "count": 453
  7. },
  8. {
  9. "name": "和讯网",
  10. "count": 95
  11. }
  12. ]
  13. }

返回参数说明

参数名 参数类型 说明
success boolean 本次请求是否有效:true有效,false失败
name string 名称,如分组展示类型hot_event:热门事件名称,keyword:关键字名称,site:站点名称,monitor_topic:关键字专题名ID
count int 舆情数量,如分组展示类型hot_event:热门事件下舆情数量,keyword:关键字下舆情数量,site:站点下舆情数量,monitor_topic:关键字专题下舆情数量

4、变更某舆情情感

API功能:此接口可以变更舆情情感,用于人工校验情感。

接口名称:setEmotion

方法:POST

入参说明

参数名 参数类型 是否必填 说明
id Long 舆情主键ID
emotionTendency int 情感趋势。1:正面,0:中性,-1:负面

返回示例

{ “success”: true, “errorCode”: null, “other”: null, “msgCode”: null, “msgInfo”: null, “messages”: [], “errorMessages”: [], “result”: 13420071 // 更新成功的舆情主键ID}

5、修改某舆情的风险等级

API功能:此接口将修改舆情的风险等级。

接口名称:setRisk

方法:POST

入参说明

参数名 参数类型 是否必填 说明
id Long 舆情主键ID
riskType int 风险等级。1:P1等级,2:P2等级,3:P3等级,4:P4等级

返回示例

{ “success”: true, “errorCode”: null, “other”: null, “msgCode”: null, “msgInfo”: null, “messages”: [], “errorMessages”: [], “result”: 13420071 // 更新成功的舆情主键ID}

6、将某舆情放入回收站

API功能:此接口用于过滤指定舆情数据,放入回收站。

接口名称:setDustbin

方法:POST

入参说明

参数名 参数类型 是否必填 说明
id Long 舆情主键ID

返回示例

{ “success”: true, “errorCode”: null, “other”: null, “msgCode”: null, “msgInfo”: null, “messages”: [], “errorMessages”: [], “result”: 13420071 // 更新成功的舆情主键ID}

7、查询舆情详情数据

API功能:用于查询舆情详情数据

接口名称:getDetail

方法:GET

入参说明

参数名 参数类型 是否必填 说明
id Long 舆情Id

返回示例

  1. {
  2. "success": true,
  3. "errorCode": null,
  4. "other": null,
  5. "msgCode": null,
  6. "msgInfo": null,
  7. "messages": [],
  8. "errorMessages": [],
  9. "messageContext": {},
  10. "result": {
  11. "id": 13679723,
  12. "productId": 13966,
  13. "spiderTopicId": 1340,
  14. "monitorKeywords": "11",
  15. "monitorKeywordId": 103028,
  16. "from": "和讯网_科技要闻",
  17. "url": "http://tech.hexun.com/2016-12-13/187322772.html",
  18. "filterStatus": 0,
  19. "createdAt": "2016-12-13T08:29:41.517Z",
  20. "pubTime": "2016-12-13T08:15:00.000Z",
  21. "wbId": null,
  22. "wbUserId": null,
  23. "wbFansCount": 0,
  24. "wbRepostCount": 0,
  25. "wbCommentCount": 0,
  26. "wbLikeCount": 0,
  27. "wbVerifiedType": 0,
  28. "wbType": 2,
  29. "emotionTendency": 1,
  30. "emotionScore": 30,
  31. "urlMD5": "f2eba50c3c881f3909ee22deaef9a5de",
  32. "tags": [],
  33. "langType": "ch",
  34. "subject": "民生银行:史玉柱持股比例增至4.97%",
  35. "description": " 证券时报网(www.stcn.com)12月13日讯 据澎湃新闻报道,根据港交所公布的权益披露,史玉柱持有的民生银行(600016,股吧)H股股份数在12月2日由7043.54万股增至6.65亿股,占民生银行H股股份比例也由1.02%升至9.59%。与此同时,晶辉国际投资有限公司持有的民生银行H股在同一天减少594584711股,与史玉柱增持的数量如出一辙。史玉柱手中的民生银行股份达到了18.15亿股,持股比例达到4.97%。`n` (证券时报e公司)`n` (责任编辑: HN666)`n` 看全文`n` 和讯网今天刊登了《`n` 民生银行:史玉柱持股比例增...",
  36. "translateSubject": null,
  37. "translateDescription": null,
  38. "clusterId": 13679723,
  39. "priority": 4,
  40. "source": "News",
  41. "attachments": [
  42. {
  43. "filename": "0000.jpg",
  44. "url": "0000.jpg"
  45. }
  46. ]
  47. }
  48. }

返回参数说明

参数名 参数类型 说明
id int 舆情对象主键
productId int 先知的产品编号
spiderTopicId int 站点组ID:与源站类型是一一对应的。
monitorKeywordId int 舆情抓取的关键字ID
monitorKeywords string 舆情抓取的关键字内容
from string 网站名/微博作者/微信公众号
url string 舆情链接。对应新闻URL/微博URL/微信公众号文章URL等
filterStatus int 0:待确认舆情,1:有效舆情 2:被过滤的舆情(放垃圾箱)
createdAt date 抓取时间
pubTime date 新闻/微博发布的时间(如果只获取到天,时分秒都为0)
wbId int 微博的主键ID
wbUserId int 微博用户的主键ID
wbFansCount int 微博粉丝数。可能在数据量大的情况下此值为空.
wbRepostCount int 微博转发数。原创微博抓取瞬间几乎都为0,如果为转发微博,建议开发者更新被转发微博的转发次数
wbCommentCount int 微博评论数。原创微博抓取瞬间几乎都为0,如果为转发微博,建议开发者更新被转发微博的评论次数
wbLikeCount int 微博点赞数。原创微博抓取瞬间几乎都为0,如果为转发微博,建议开发者更新被转发微博的点赞次数
wbVerifiedType int 微博用户认证类型 0-普通,1-个人认证,2-企业认证,3-微博达人。可能在数据量大的情况下此值为空。
wbType int 微博类型:0为原创微博,1为转发微博,2为微博评论
emotionTendency int 情感极性0中性 1正面 -1负面
emotionScore int 情感分数,绝对值越大,表示对应的情感越强烈
urlMD5 string url的md5哈希值
tags string 自动打上的标签,多个会用竖线进行分隔。
langType string 语言类型。如ch表示中文,en表示英文
subject string 文章标题。如果是微博,则为微博内容的摘要。
description string 正文摘要(300字以内)。如果是微博,则为微博内容的前300个字符,正文中的“[[+_+]]”是图片占位符,配合attachments使用
translateSubject string 如果是非中文和英文,翻译成英文之后的标题
translateDescription string 如果是非中文和英文,翻译成英文之后的详情
clusterId int 相似舆情的中心结点主键,在search接口传入此参数可查询与该条舆情相似的其他舆情数据
priority int 优先级,1到4表示P1到P4
attachments string 图片信息,string是一个list,其中filename是图片标识,标识中的数字是图片从上至下的顺序,比如0000代表第一张图片,url是图片的地址。

六、微博相关接口

1、创建微博分析任务

API功能:该接口可用于分析5条转发以上的微博。调用该接口后,会产生一个分析任务,通过轮询查询微博分析结果接口,可获取分析结果的完成情况。

接口名称:weiboAnalysis

方法:POST

入参说明

参数名 参数类型 是否必填 说明
url string 单条微博的url地址。可点击微博的发布时间查看单条微博URL

返回示例

  1. {
  2. "success":true,
  3. "errorCode":null
  4. "other":null,
  5. "msgCode":null,
  6. "msgInfo":null,
  7. "messages":[],
  8. "result":552 // 生成的微博分析任务主键ID。可用此ID查询分析结果
  9. }

2、获取微博分析历史列表

API功能:获取微博分析历史列表

接口名称:getWeiboAnalysisHistory

方法:GET

入参说明

参数名 参数类型 是否必填 说明
toPage int 页码(默认1)

2、查询微博分析结果

API功能:获取微博分析的结果。由于分析需要一定的时间,通常为30次转发/秒,前端可根据此时间进行时间预估。当取得分析结果接口中的data不为null时,表示分析已经完成。

接口名称:getWeiboAnalysisResult

方法:GET

入参说明

参数名 参数类型 是否必填 说明
id int 微博分析任务主键ID

返回示例

分析中(data为null)

  1. { success: true,
  2. result:
  3. { id: 559,
  4. weiboUrl: 'http://weibo.com/1622004114/DsAI319Ai?from=page_1006061622004114_profile&wvr=6&mod=weibotime&type=comment',
  5. uid: null,
  6. screenName: null,
  7. content: '#QCon北京2016# 运维专场开场《海量容器系统运维实践》的讲稿实录,从多Region异地多活,统一接入和安全,Overlay网络虚拟化,以及应用模型和弹性计算几个方面来说如何做高质量架构产品化输出@QCon全球软件开发大会 @InfoQ @开发者头条 @阿里云 @阿里技术嘉年华 http://t.cn/Rq0du7c',
  8. uInfo: null,
  9. wInfo:
  10. { annotations: '',
  11. attitudesCount: 3,
  12. bmiddlePic: '',
  13. commentsCount: 12,
  14. createdAt: 1461562476000,
  15. favorited: false,
  16. geo: 'null',
  17. id: '3968142990275174',
  18. idstr: 3968142990275174,
  19. inReplyToScreenName: '',
  20. inReplyToStatusId: -1,
  21. inReplyToUserId: -1,
  22. latitude: -1,
  23. longitude: -1,
  24. mid: '3968142990275174',
  25. mlevel: 0,
  26. originalPic: '',
  27. picIds: [],
  28. picUrls: [],
  29. repostsCount: 35,
  30. source: [Object],
  31. text: '#QCon北京2016# 运维专场开场《海量容器系统运维实践》的讲稿实录,从多Region异地多活,统一接入和安全,Overlay网络虚拟化,以及应用模型和弹性计算几个方面来说如何做高质量架构产品化输出@QCon全球软件开发大会 @InfoQ @开发者头条 @阿里云 @阿里技术嘉年华 http://t.cn/Rq0du7c',
  32. thumbnailPic: '',
  33. truncated: false,
  34. user: [Object],
  35. visible: [Object] },
  36. totalFollows: null,
  37. simpleReport: null,
  38. detailReport: null,
  39. data: null,
  40. graphData: null,
  41. pubTime: Mon Apr 25 2016 13:34:36 GMT+0800 (CST),
  42. createdAt: Thu Apr 28 2016 17:32:29 GMT+0800 (CST),
  43. updatedAt: Thu Apr 28 2016 17:32:29 GMT+0800 (CST) } }

分析后(data不为null)

  1. { success: true,
  2. result:
  3. { id: 559,
  4. weiboUrl: 'http://weibo.com/1622004114/DsAI319Ai?from=page_1006061622004114_profile&wvr=6&mod=weibotime&type=comment',
  5. uid: '1622004114',
  6. screenName: '淘宝开放平台',
  7. content: '#QCon北京2016# 运维专场开场《海量容器系统运维实践》的讲稿实录,从多Region异地多活,统一接入和安全,Overlay网络虚拟化,以及应用模型和弹性计算几个方面来说如何做高质量架构产品化输出@QCon全球软件开发大会 @InfoQ @开发者头条 @阿里云 @阿里技术嘉年华 http://t.cn/Rq0du7c',
  8. uInfo:
  9. { allowAllActMsg: true,
  10. allowAllComment: false,
  11. avatarLarge: 'http://tp3.sinaimg.cn/1622004114/180/1284433074/1',
  12. biFollowersCount: 192,
  13. city: 1,
  14. createdAt: 1258688488000,
  15. description: '淘宝开放平台是将阿里巴巴内部的商业和能力开放出来,赋能整个商业生态。 进化新商业,开放新思维。 平台动态请关注:https://open.taobao.com 更多官方变更请关注官方公:http://open.taobao.com/support/announcement_list.htm',
  16. favouritesCount: 1,
  17. followMe: false,
  18. followersCount: 38483,
  19. following: true,
  20. friendsCount: 247,
  21. gender: 'm',
  22. id: '1622004114',
  23. lang: 'zh-cn',
  24. location: '浙江 杭州',
  25. name: '淘宝开放平台',
  26. onlineStatus: 0,
  27. profileImageURL: 'http://tp3.sinaimg.cn/1622004114/50/1284433074/1',
  28. profileImageUrl: 'http://tp3.sinaimg.cn/1622004114/50/1284433074/1',
  29. province: 33,
  30. screenName: '淘宝开放平台',
  31. statusId: '',
  32. statusesCount: 1764,
  33. uRL: 'http://open.taobao.com',
  34. url: 'http://open.taobao.com',
  35. userDomain: 'opentaobao',
  36. verified: true,
  37. verifiedReason: '淘宝开放平台部门官方微博',
  38. verifiedType: 2,
  39. verified_reason: '淘宝开放平台部门官方微博',
  40. weihao: '' },
  41. wInfo:
  42. { annotations: '',
  43. attitudesCount: 3,
  44. bmiddlePic: '',
  45. commentsCount: 12,
  46. createdAt: 1461562476000,
  47. favorited: false,
  48. geo: 'null',
  49. id: '3968142990275174',
  50. idstr: 3968142990275174,
  51. inReplyToScreenName: '',
  52. inReplyToStatusId: -1,
  53. inReplyToUserId: -1,
  54. latitude: -1,
  55. longitude: -1,
  56. mid: '3968142990275174',
  57. mlevel: 0,
  58. originalPic: '',
  59. picIds: [],
  60. picUrls: [],
  61. repostsCount: 35,
  62. source: [Object],
  63. text: '#QCon北京2016# 运维专场开场《海量容器系统运维实践》的讲稿实录,从多Region异地多活,统一接入和安全,Overlay网络虚拟化,以及应用模型和弹性计算几个方面来说如何做高质量架构产品化输出@QCon全球软件开发大会 @InfoQ @开发者头条 @阿里云 @阿里技术嘉年华 http://t.cn/Rq0du7c',
  64. thumbnailPic: '',
  65. truncated: false,
  66. user: [Object],
  67. visible: [Object] },
  68. totalFollows: 38483,
  69. simpleReport: '消息曝光量<span title="曝光量表示所有转发用户的总粉丝数">404536</span>,共计转发<b>35</b>次,其中一转<b>17</b>次,二转<b>16</b>次,三转<b>1</b>次,北京、浙江、上海地区参与转发人数较多。用户情绪指数为<b>99</b>,传递了超强的正能量。没有发现任何疑似水军。',
  70. detailReport: null,
  71. data:
  72. { areaMap: [ // 微博转发地域分析
  73. { key: '北京', value: 15 },
  74. { key: '浙江', value: 8 },
  75. { key: '上海', value: 3 },
  76. { key: '江苏', value: 3 },
  77. { key: '山东', value: 2 },
  78. { key: '广东', value: 2 },
  79. { key: '其他', value: 1 },
  80. { key: '海外', value: 1 } ],
  81. emotion: 99, // 情感值
  82. levelList: [ 17, 16, 1, 0 ], // 转发层级分析
  83. sexMap: { '女': 1, '男': 34 }, // 性别比例
  84. timeList: [Object], //转发时间曲线数据
  85. top100User: [ // 关键传播账号
  86. { followersCount: 414,
  87. friendsCount: 354,
  88. gender: 'm',
  89. postTime: 1461581414000,
  90. repostCount: 6,
  91. screenName: 'wisdomyu',
  92. statusMid: '3968222422190527',
  93. userId: '1428493165',
  94. verifiedType: '普通用户' },
  95. { followersCount: 25352,
  96. friendsCount: 669,
  97. gender: 'm',
  98. postTime: 1461563724000,
  99. repostCount: 5,
  100. screenName: '阿里技术嘉年华',
  101. statusMid: '3968148225362229',
  102. userId: '1939498534',
  103. verifiedType: '企业认证(企业)' },
  104. { followersCount: 16613,
  105. friendsCount: 231,
  106. gender: 'm',
  107. postTime: 1461564477000,
  108. repostCount: 4,
  109. screenName: '阿里技术保障',
  110. statusMid: '3968151388144939',
  111. userId: '3851645388',
  112. verifiedType: '企业认证(企业)' },
  113. { followersCount: 957,
  114. friendsCount: 874,
  115. gender: 'm',
  116. postTime: 1461597070000,
  117. repostCount: 1,
  118. screenName: '臧秀涛',
  119. statusMid: '3968288091950552',
  120. userId: '2710829805',
  121. verifiedType: '个人认证(名人)' },
  122. { followersCount: 23384,
  123. friendsCount: 118,
  124. gender: 'm',
  125. postTime: 1461566131000,
  126. repostCount: 1,
  127. screenName: '阿里数据',
  128. statusMid: '3968158325129144',
  129. userId: '2414452832',
  130. verifiedType: '企业认证(企业)' },
  131. { followersCount: 8531,
  132. friendsCount: 217,
  133. gender: 'm',
  134. postTime: 1461651555000,
  135. repostCount: 1,
  136. screenName: 'Docker精选',
  137. statusMid: '3968516614579106',
  138. userId: '5360910133',
  139. verifiedType: '普通用户' } ],
  140. totalFollows: 404536,
  141. userTypeMap: { '个人认证': 3, '企业认证': 9, '微博达人': 4, '普通用户': 19 }, // 用户类型
  142. waterArmyMap: { false: 35, true: 0 } // 水军分析
  143. },
  144. graphData: ....., //路径传播图 xml数据
  145. pubTime: Mon Apr 25 2016 13:34:36 GMT+0800 (CST),
  146. createdAt: Thu Apr 28 2016 17:32:29 GMT+0800 (CST),
  147. updatedAt: Thu Apr 28 2016 17:32:32 GMT+0800 (CST) } }

传播链接的展示推荐使用gephi组件。

七、首页报表接口

1、源站类型分析

API功能:查询某个时间点的不同源站下的舆情数量

接口名称:queryReportNumber

方法: GET

入参说明

参数名 参数类型 说明 是否必填
keyWordTopicId int 专题ID,不传则获取全部专题的源站类型
time int 时间,如20160121
timeType int 过滤的时间类型,0为当天,1为近七天,2为近30天。不传则默认为0

返回示例

  1. {
  2. "success": true,
  3. "messages": [ ],
  4. "result": [
  5. {
  6. "logDate": 20161012,
  7. "sourceName": "新闻",
  8. "value": 871
  9. }]
  10. }

返回参数说明

参数名 参数类型 说明
logDate Date 登录时间。时间格式为UTC时间
sourceName string 源站的中文名
value int 舆情的数量(timeType为0表示当天数据,1为近七天,2为近30天)

2、情感分析

API功能:查询某个专题下某个时间点的情感分值

接口名称:queryReportEmotion

方法: GET

入参说明

参数名 参数类型 说明 是否为空
keyWordTopicId int 专题ID,不传则表示查询总体的情感值
time int 时间,如20160121
timeType int 过滤的时间类型,0为当天,1为近七天,2为近30天,不传则默认为0

返回示例

  1. {
  2. "success": true,
  3. "result": {
  4. "logDate": 20160922,
  5. "value": 14
  6. },
  7. "messages": []
  8. }

返回参数说明

参数名 参数类型 说明
logDate Date 采集时间点。时间格式为UTC时间
value int 情感分值(timeType为0表示当天数据,1为近七天,2为近30天)

3、热词云

API功能:查询热词云

接口名称:queryReportHotWord

方法: GET

入参说明

参数名 参数类型 说明 是否必填
keyWordTopicId int 专题ID,不传则表示查询全部专题下的热词云
time int 时间,如20160121
timeType int 过滤的时间类型,0为当天,1为近七天,2为近30天,不传则默认为0

返回示例

  1. {
  2. "success": true,
  3. "result": {
  4. "logDate": 20160922,
  5. "listData": [
  6. {
  7. "name": "破土",
  8. "count": 187
  9. }],
  10. "messages": []
  11. }

返回参数说明

参数名 参数类型 说明
logDate Date 计算时间点。时间格式为UTC时间
listData list 各关键字对应的详情
listData.name string 热词名称
listData.count int 热词的舆情统计数量

4、热门事件

API功能:查询时间点下热门事件及舆情数量

接口名称:queryReportHotEvent

方法: GET

入参说明

参数名 参数类型 说明 是否必填
keyWordTopicId int 专题ID,不传表示查询全部专题下的热门事件
time int 时间,如20160121
timeType int 过滤的时间类型,0为当天,1为近七天,2为近30天,不传则默认为0

返回示例

  1. {
  2. "success": true,
  3. "result": {
  4. "logDate": 20160922,
  5. "listData": [
  6. {
  7. "name": "【实时路况】#出行提示#8:30分,虹桥枢纽周边道路情况(绿色为畅通,...",
  8. "count": 44
  9. }
  10. ]
  11. },
  12. "messages": []
  13. }

返回参数说明

参数名 参数类型 说明
logDate Date 采集时间。时间格式为UTC时间
listData list 各热门时间对应的详情
listData.name string 热门事件名称
listData.count int 热门事件的舆情统计数量

5、专题分析

API功能:分析每个专题下的舆情数量

接口名称:queryReportTopic

方法: GET

入参说明

参数名 参数类型 说明 是否为空
keyWordTopicId int 专题ID,不传表示查询所有专题的舆情数量
time int 时间,如20160121
timeType int 过滤的时间类型,0为当天,1为近七天,2为近30天,不传则默认为0

返回示例

  1. {
  2. "success": true,
  3. "result": {
  4. "logDate": 20160922,
  5. "value": 1309
  6. },
  7. "messages": []
  8. }

返回参数说明

参数名 参数类型 说明
logDate Date 采集时间。时间格式为UTC时间
value int 该专题下的舆情数量(timeType为0表示当天数据,1为近七天,2为近30天)

6、关键字分析

API功能:某个专题下不同关键字的舆情数量

接口名称:queryReportKeyWord

方法: GET

入参说明

参数名 参数类型 说明 是否必填
keyWordTopicId int 专题ID,不传表示查询所有专题下的关键字舆情数量
time int 时间,如20160121
timeType int 过滤的时间类型,0为当天,1为近七天,2为近30天,不传则默认为0

返回示例

  1. {
  2. "success": true,
  3. "result": {
  4. "logDate": 20160922,
  5. "listData": [
  6. {
  7. "name": "【实时路况】#出行提示#8:30分,虹桥枢纽周边道路情况(绿色为畅通,...",
  8. "count": 44
  9. },
  10. {
  11. "name": "10月16日#2016南京马拉松# 比赛期间,江东中路等部分道路分段实...",
  12. "count": 26
  13. }
  14. ]
  15. },
  16. "messages": []
  17. }

返回参数说明

参数名 参数类型 说明
logDate Date 采集时间。时间格式为UTC时间
listData list 各关键字对应的详情
listData.name string 关键字名称
listData.count int 关键字的舆情统计数量

7、标签分析

接口名称:queryReportTagAnalysis

方法: GET

入参说明

参数名 参数类型 说明 是否必填
keyWordTopicId int 专题ID,不传表示获取全部专题
time int 时间,如20160121
timeType int 过滤的时间类型,0为当天,1为近七天,2为近30天,不传则默认为0

返回示例

  1. {
  2. "success": true,
  3. "result": [
  4. {
  5. "logDate": 20160922,
  6. "tagName": "活动",
  7. "feedbackCount": 626
  8. },
  9. {
  10. "logDate": 20160922,
  11. "tagName": "事故",
  12. "feedbackCount": 2939
  13. }
  14. ],
  15. "messages": []
  16. }

返回参数说明

参数名 参数类型 说明
logDate Date 登录时间。时间格式为UTC时间
feedbackCount int 标签下的所有反馈数(timeType为0表示当天数据,1为近七天,2为近30天)
tagName string 标签名称

8、舆情趋势

API功能:查询某个专题下的舆情趋势

接口名称:queryReportNumberTrend

方法: GET

入参说明

参数名 参数类型 说明 是否必填
keyWordTopicId int 专题ID,不传表示查询全部专题下的舆情趋势
time int 采集时间,如20160121
timeType int 过滤的时间类型,0为当天,1为近七天,2为近30天,不传则默认为0

返回示例

  1. {
  2. "success": true,
  3. "result": [
  4. {
  5. "logDate": 20161006,
  6. "value": 110
  7. },
  8. {
  9. "logDate": 20161007,
  10. "value": 19
  11. }],
  12. "messages": []
  13. }

返回参数说明

参数名 参数类型 说明
logDate int 采集时间,按日期维度。(timeType为1或者2时,此参数有效)
hout int 采集时间,按小时维度。(timeType为0时,此参数有效)
value int 舆情数量(timeType为0表示当天数据,1为近七天,2为近30天)

9、情感趋势分析

API功能:查询情感趋势分析

接口名称:queryReportEmotionTrend

方法: GET

入参说明

参数名 参数类型 说明 是否必填
keyWordTopicId int 专题ID,不传表示查询全部专题下的情感值趋势
time int 采集时间,如20160121
timeType int 过滤的时间类型,0为当天,1为近七天,2为近30天,不传则默认是0

返回示例

  1. {
  2. "success": true,
  3. "result": [
  4. {
  5. "hour":1,
  6. "value": 9
  7. },
  8. {
  9. "hour":2,
  10. "value": 13
  11. }],
  12. "messages": []
  13. }

返回参数说明

参数名 参数类型 说明
logDate int 采集时间,按日期维度。(timeType为1或者2时,此参数有效)
hout int 采集时间,按小时维度。(timeType为0时,此参数有效)
value int 情感值(timeType为0表示当天数据,1为近七天,2为近30天)

八、预警接口

发送预警时,发送metaQ消息,标识tag是“alarm”,实时触发发送metaQ消息。

1、新增预警

API功能:添加预警,并配置预警的数据范围、预警条件及预警人

接口名称:addAlarm

方法: POST

入参说明

参数名 参数类型 说明 是否必填
name string 预警规则名称
query string 预警的数据范围,必须是json string的格式,其中json中必须有的key值是createAtHour和createAtMinute,分别表示时间的小时和分钟的数值,其他参数见下面json属性
alarmRule int 预警条件中的阈值
alarmRuleType int 选中的预警条件(1是与上一时间周期相比增长的百分比;3是与上一时间周期相比,增长的条数;2是在本时间周期内,数量达到的条数;4是在本时间周期内,出现相似问题的条数)
timeStart string 发送预警通知的开始时间
timeEnd string 发送预警通知的结束时间
telephone string 需要通过短信发送预警的用户ID,用空格区分
email string 需要通过邮件发送预警的用户ID,用空格区分
ccEmail string 需要通过邮件抄送发送预警的用户ID,用空格区分

query参数示例

query参数标识数据范围,数据范围中所有选择字段全部以Json传给后端,以下是来源为”微信”的json格式

  1. {
  2. "spiderTopicId": "9112", // 站点组ID,报警配置编辑页面查看源站类型radio选中的value值
  3. "createdAtHour": "13", //时间范围,小时
  4. "createdAtMinute": "59", //时间访问,分钟
  5. "priority": "1", //优先级
  6. "emotionTendency": "0", //情感
  7. "tagIds": ["1008113","1008112"], //标签,这里需要填Id,",
  8. "crawlerKeywords": "测试", //关键字
  9. "description": //"内容包含的文本",
  10. "contentNotContains": //"内容不包含的文本",
  11. "tbNickname": "网易", //来源
  12. }

返回示例

  1. {
  2. "success": true,
  3. "result": {
  4. "id": 2524,
  5. "name": "预警规则名称",
  6. "status": 0,
  7. "alarmRule": "25",
  8. "alarmRuleType": 1,
  9. "query": " {"createdAtDuration":"732", "createdAtHour":"12", "createdAtMinute":"12", "csf" : "{}"} ",
  10. "email": "hehe.com",
  11. "ccEmail": "",
  12. "telephone": "",
  13. "userId": 10842734,
  14. "timeStart": "12:00",
  15. "timeEnd": "13:00",
  16. "latestTime": null
  17. },
  18. "messages": []
  19. }

返回参数说明

参数名 参数类型 说明
id int 预警规则的ID
name string 预警规则名称
query string 预警的数据范围,必须是json string的格式,其中json中的key值createAtHour和createAtMinute,分别表示时间的小时和分钟的数值
alarmRule int 预警条件中的阈值
alarmRuleType int 选中的预警条件(1是与上一时间周期相比增长的百分比;3是与上一时间周期相比,增长的条数;2是在本时间周期内,数量达到的条数;4是在本时间周期内,出现相似问题的条数)
timeStart string 发送预警的开始时间
timeEnd string 发送预警的结束时间
telephone string 需要通过短信发送预警的用户ID,用空格区分
email string 需要通过邮件发送预警的用户ID,用空格区分
ccEmail string 需要通过邮件抄送发送预警的用户ID,用空格区分

2、更新预警

API功能:更新预警信息

接口名称:updateAlarm

方法: POST

入参说明

参数名 参数类型 说明 是否必填
id int 预警规则的ID
name string 预警规则名称
query string 预警的数据范围,必须是json string的格式,其中json中必须有的key值是createAtHour和createAtMinute,分别表示时间的小时和分钟的数值
alarmRule int 预警条件中的阈值
alarmRuleType int 选中的预警条件(1是与上一时间周期相比增长的百分比;3是与上一时间周期相比,增长的条数;2是在本时间周期内,数量达到的条数;4是在本时间周期内,出现相似问题的条数)
timeStart string 发送预警通知的开始时间
timeEnd string 发送预警通知的结束时间
telephone string 需要通过短信发送预警的用户ID,用空格区分
email string 需要通过邮件发送预警的用户ID,用空格区分
ccEmail string 需要通过邮件抄送发送预警的用户ID,用空格区分

返回示例

  1. {
  2. "success": true,
  3. "result": {
  4. "id": 2524,
  5. "name": "预警规则名称",
  6. "status": 0,
  7. "alarmRule": "25",
  8. "alarmRuleType": 1,
  9. "query": " {"createdAtDuration":"732", "createdAtHour":"12", "createdAtMinute":"12", "csf" : "{}"} ",
  10. "email": "hehe.com",
  11. "ccEmail": "",
  12. "telephone": "",
  13. "userId": 10842734,
  14. "timeStart": "12:00",
  15. "timeEnd": "13:00",
  16. "latestTime": null
  17. },
  18. "messages": []
  19. }

返回参数说明

参数名 参数类型 说明
id int 预警规则的ID
name string 预警规则名称
query string 预警的数据范围,必须是json string的格式,其中json中的key值createAtHour和createAtMinute,分别表示时间的小时和分钟的数值
alarmRule int 预警条件中的阈值
alarmRuleType int 选中的预警条件(1是与上一时间周期相比增长的百分比;3是与上一时间周期相比,增长的条数;2是在本时间周期内,数量达到的条数;4是在本时间周期内,出现相似问题的条数)
timeStart string 发送预警的开始时间
timeEnd string 发送预警的结束时间
telephone string 需要通过短信发送预警的用户ID,用空格区分
email string 需要通过邮件发送预警的用户ID,用空格区分
ccEmail string 需要通过邮件抄送发送预警的用户ID,用空格区分

3、删除预警

API功能:根据预警的ID,删除该预警规则

接口名称:deleteAlarmById

方法: POST

入参说明

参数名 参数类型 说明 是否必填
id int 预警规则的ID

返回示例

  1. {
  2. "success": true,
  3. "result": true,
  4. "messages": []
  5. }

返回参数说明

参数名 参数类型 说明
result bool 删除预警是否成功

4、查询单个预警规则

API功能:根据预警的ID,查询该预警规则

接口名称:queryAlarmById

方法: GET

入参说明

参数名 参数类型 说明 是否必填
id int 预警规则的ID

返回示例

  1. {
  2. "success": true,
  3. "result": {
  4. "id": 2524,
  5. "name": "预警规则名称",
  6. "status": 0,
  7. "alarmRule": "25",
  8. "alarmRuleType": 1,
  9. "query": " {"createdAtDuration":"732", "createdAtHour":"12", "createdAtMinute":"12"} ",
  10. "email": "hehe.com",
  11. "ccEmail": "",
  12. "telephone": "",
  13. "userId": 10842734,
  14. "timeStart": "12:00",
  15. "timeEnd": "13:00",
  16. "latestTime": null
  17. },
  18. "messages": []
  19. }

返回参数说明

参数名 参数类型 说明
id int 预警规则的ID
name string 预警规则名称
query string 预警的数据范围,必须是json string的格式,其中json中的key值createAtHour和createAtMinute,分别表示时间的小时和分钟的数值
alarmRule int 预警条件中的阈值
alarmRuleType int 选中的预警条件(1是与上一时间周期相比增长的百分比;3是与上一时间周期相比,增长的条数;2是在本时间周期内,数量达到的条数;4是在本时间周期内,出现相似问题的条数)
timeStart string 发送预警的开始时间
timeEnd string 发送预警的结束时间
telephone string 需要通过短信发送预警的用户ID,用空格区分
email string 需要通过邮件发送预警的用户ID,用空格区分
ccEmail string 需要通过邮件抄送发送预警的用户ID,用空格区分

5、查询当前用户的所有预警规则

API功能:查询该用户创建的所有预警,支持分页

接口名称:getAlarms

方法: GET

入参说明

参数名 参数类型 说明 是否必填
pageIndex int 分页下标,默认是第一页
pageSize int 分页大小,默认是每页20个

返回示例

  1. {
  2. "success": true,
  3. "result": [
  4. {
  5. "id": 2532,
  6. "name": "测试规则A",
  7. "status": 1,
  8. "alarmRule": "25",
  9. "alarmRuleType": 1,
  10. "query": "{\"createdAtHour\":\"11\",\"createdAtMinute\":\"11\",\"cfs\":{}}",
  11. "email": "test@163.com",
  12. "ccEmail": "",
  13. "telephone": "",
  14. "userId": 121212,
  15. "timeStart": "12:00",
  16. "timeEnd": "13:00",
  17. "latestTime": null
  18. },
  19. {
  20. "id": 2547,
  21. "name": "测试规则B",
  22. "status": 0,
  23. "alarmRule": "25",
  24. "alarmRuleType": 1,
  25. "query": "{\"createdAtHour\":\"11\",\"createdAtMinute\":\"11\",\"cfs\":{}}",
  26. "email": "",
  27. "ccEmail": "",
  28. "telephone": "",
  29. "userId": 121212,
  30. "timeStart": "12:00",
  31. "timeEnd": "13:00",
  32. "latestTime": null
  33. }
  34. ],
  35. "pageSize": 20,
  36. "toPage": 1,
  37. "totalCount": 2,
  38. "totalPages": 1,
  39. "messages": []
  40. }

返回参数说明

参数名 参数类型 说明
toPage int 分页下标
pageSize int 每页数量
totalPages int 总页数
totalCount int 返回总的预警数量
id int 预警规则的ID
name string 预警规则名称
query string 预警的数据范围,必须是json string的格式,其中json中的key值createAtHour和createAtMinute,分别表示时间的小时和分钟的数值
alarmRule int 预警条件中的阈值
alarmRuleType int 选中的预警条件(1是与上一时间周期相比增长的百分比;3是与上一时间周期相比,增长的条数;2是在本时间周期内,数量达到的条数;4是在本时间周期内,出现相似问题的条数)
timeStart string 发送预警的开始时间
timeEnd string 发送预警的结束时间
telephone string 需要通过短信发送预警的用户ID,用空格区分
email string 需要通过邮件发送预警的用户ID,用空格区分
ccEmail string 需要通过邮件抄送发送预警的用户ID,用空格区分

6、获取产品下成员信息

API功能:查询产品下成员信息,用于增加预警时指定发送预警的用户ID

接口名称:queryMembers

方法: GET

入参说明

无参数

返回示例

  1. {
  2. "success": true,
  3. "errorCode": null,
  4. "other": null,
  5. "msgCode": null,
  6. "msgInfo": null,
  7. "messages": [],
  8. "errorMessages": [],
  9. "result": [
  10. {
  11. "userId": 1212,
  12. "roleId": 2249,
  13. "account": "test_1"
  14. },
  15. {
  16. "userId": 1313,
  17. "roleId": 2249,
  18. "account": "test_2"
  19. }
  20. ]
  21. }

返回参数说明

参数名 参数类型 说明
userId Long 成员用户user_id
roleId int 成员角色Id,2250:操作者角色,100009:查看者角色,2249:管理者角色
account string 成员用户名称

九、热词接口

1、搜索热词

API功能:搜索热词

接口名称:getHotWordList

方法: GET

入参说明

参数名 参数类型 说明 是否必填
word String 搜索词
toPage int 分页页码,默认是1
pageSize int 分页大小,默认是每页20个

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "hotWordWeight": 0.00523498,
  8. "emotionScore": 9.893,
  9. "hotWord": "梦想小镇",
  10. "hotWordWeightDiff": 0.0049513414455823
  11. },
  12. {
  13. "hotWordWeight": 0.0000147,
  14. "emotionScore": 10,
  15. "hotWord": "仓前梦想小镇",
  16. "hotWordWeightDiff": 0.000014695848614
  17. }
  18. ],
  19. "msgInfo": null,
  20. "errorCode": 0,
  21. "other": null,
  22. "pageSize": 20,
  23. "toPage": 1,
  24. "totalCount": 2,
  25. "totalPages": 1
  26. }

返回参数说明

参数名 参数类型 说明
toPage int 分页下标
pageSize int 每页数量
totalPages int 总页数
totalCount int 匹配到的总数量
hotWordWeight double 热词热度
emotionScore double 热词情感分(-100到100)
hotWordWeightDiff double 热词热度上升度
hotWord string 热词

2、获取热词属性及相关词

API功能:获取热词属性及相关词,包括热词情感、舆情趋势、关联词

接口名称:getHotWordNet

方法: GET

入参说明

参数名 参数类型 说明 是否必填
hotWord String 热词

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": {
  6. "hotWordWeight": 0.00523498,
  7. "hotWord": "梦想小镇",
  8. "feedemotionList": [
  9. {
  10. "emotionScore": 8.097,
  11. "feedBackCount": 98,
  12. "logDate": 1489939200000
  13. },
  14. {
  15. "emotionScore": 9.7633,
  16. "feedBackCount": 73,
  17. "logDate": 1490025600000
  18. }
  19. ],
  20. "relationWordList": [
  21. {
  22. "relationWord": "浙江",
  23. "relationWordWeight": 0.0005884591,
  24. "relationWordWeightDiff": -0.0210500289,
  25. "relationWeight": 0.112409
  26. },
  27. {
  28. "relationWord": "资本",
  29. "relationWordWeight": 0.0000664578,
  30. "relationWordWeightDiff": -0.0285229567,
  31. "relationWeight": 0.012695
  32. }
  33. ],
  34. "hotWordWeightDiff": 0.0049513414455823
  35. },
  36. "msgInfo": null,
  37. "errorCode": 0,
  38. "other": null
  39. }

返回参数说明

参数名 参数类型 说明
emotionScore double 热词情感值
feedBackCount int 包含热词的舆情量
logDate long 相对日期毫秒值
relationWord string 热词关联词
relationWordWeight double 关联词热度
relationWordWeightDiff double 关联词热度上升度
relationWeight double 关联词和热词关联度
hotWord string 热词
hotWordWeight doule 热词热度
hotWordWeightDiff doule 热词热度上升度

3、获取专题热词

API功能:获取指定专题下热词

接口名称:getTopicHotWordNet

方法:GET

入参说明

参数名 参数类型 说明 是否必填
topicId int 专题ID

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "hotWordWeight": 0.00660441,
  8. "topicId": 6319,
  9. "hotWord": "梦想小镇",
  10. "hotWordWeightDiff": 0.00655982
  11. },
  12. {
  13. "hotWordWeight": 0.00307414,
  14. "topicId": 6319,
  15. "hotWord": "杭州",
  16. "hotWordWeightDiff": 0.0026185
  17. }
  18. ],
  19. "msgInfo": null,
  20. "errorCode": 0,
  21. "other": null
  22. }

返回参数说明

参数名 参数类型 说明
topicId int 专题ID
hotWord string 热词
hotWordWeight double 热词热度
hotWordWeightDiff double 热词热度上升度

4、获取热词舆情列表

API功能:获取包含热词的舆情列表

接口名称:getHotWordYQList

方法:GET

入参说明

参数名 参数类型 说明 是否必填
subject string 舆情标题匹配词
description string 舆情正文匹配词 否(subject与description至少有一个)
from string 来源
spiderTopicId int 源站类型ID
monitorTopicId int 专题ID
emotionTendencys int 情感分类(-1(消极),0(中立),1(积极))
createTimeBegin long 舆情创建起始时间(秒)
createTimeEnd long 舆情创建截止时间(秒)
pubTimeBegin long 舆情发布开始时间(秒)
pubTimeEnd long 舆情发布截止时间(秒)
pageIndex int 分页下标(默认1)
pageSize int 分页页长(默认10)

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "id": 2542439507,
  8. "createdAt": 1490709692,
  9. "from":"1234"
  10. "emotionTendency": 1,
  11. "subject": "杭州梦想小镇迎两周岁生日:废弃粮仓蜕变创业天堂_网易新闻",
  12. "description": " (原标题:杭州梦想小镇迎两周岁生日:废弃粮仓蜕变创业天堂) \n中新网杭州3月28日电(王逸飞 宋唯岚)“携手追梦,共筑未来”。28日,一场以此为主题,云集众多互联网创客、投资机构负责人的生日庆典在浙",
  13. "wbFansCount": 0,
  14. "wbRepostCount": 0,
  15. "wbUserId": -1,
  16. "wbCommentCount": 0,
  17. "crawlerKeywords": "海创园",
  18. "urlMd5": "2398ac8eebc71c1479b3c86d19c32519",
  19. "pubTime": 1490709060,
  20. "keywords": "海创园",
  21. "monitorKeywordId": 188410,
  22. "wbLikeCount": 0,
  23. "wbCertificate": 0,
  24. "spiderTopicId": 9014,
  25. "monitorTopicId": 123,
  26. "refererUrl": "http://news.163.com/17/0328/21/CGL7JHCO000187V5.html",
  27. "emotionScore": 9
  28. }
  29. ],
  30. "msgInfo": null,
  31. "errorCode": 0,
  32. "other": null,
  33. "pageSize": 10,
  34. "toPage": 1,
  35. "totalCount": 847,
  36. "totalPages": 85
  37. }

返回参数说明

参数名 参数类型 说明
id long 舆情主键ID
createdAt long 舆情创建时间(秒)
subject string 舆情标题
description string 舆情概要描述
crawlerKeywords string 抓取关键词
urlMd5 string url的md5值
pubTime long 舆情发布时间(秒)
monitorKeywordId int 关键词ID
productId int 先知的产品编号
spiderTopicId int 站点组ID:与源站类型是一一对应的。
monitorTopicId int 专题ID
from string 来源
refererUrl string 舆情链接。对应新闻URL/微博URL/微信公众号文章URL等
wbUserId int 微博用户的主键ID
wbFansCount int 微博粉丝数。可能在数据量大的情况下此值为空.
wbRepostCount int 微博转发数。原创微博抓取瞬间几乎都为0,如果为转发微博,建议开发者更新被转发微博的转发次数
wbCommentCount int 微博评论数。原创微博抓取瞬间几乎都为0,如果为转发微博,建议开发者更新被转发微博的评论次数
wbLikeCount int 微博点赞数。原创微博抓取瞬间几乎都为0,如果为转发微博,建议开发者更新被转发微博的点赞次数
wbCertificate int 微博用户认证类型 0-普通,1-个人认证,2-企业认证,3-微博达人。可能在数据量大的情况下此值为空。
emotionTendency int 情感极性,0中性 1正面 -1负面
emotionScore int 情感分数,绝对值越大,表示对应的情感越强烈

5、获取热词来源统计

API功能:获取热词个来源站点统计

接口名称:getHotWordSourceCount

方法:GET

入参说明

参数名 参数类型 说明 是否必填
hotWord string 热词
timeIntervalType int 时间区间类型,0 最近1天 、1 最近7天 、2 最近30天。 默认是0

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "name": "21世纪",
  8. "count": 1
  9. },
  10. {
  11. "name": "263财富网",
  12. "count": 1
  13. }
  14. ],
  15. "msgInfo": null,
  16. "errorCode": 0,
  17. "other": null
  18. }

返回参数说明

参数名 参数类型 说明
name string 来源名称
count int 舆情数量

6、获取热词情感分类统计

API功能:获取热词个来源站点统计

接口名称:getHotWordMotionCount

方法:GET

入参说明

参数名 参数类型 说明 是否必填
hotWord string 热词
timeIntervalType int 时间区间类型,0 最近一天 、1 最近7天 、2 最近30天。 默认是0

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "name": "0",
  8. "count": 26
  9. },
  10. {
  11. "name": "1",
  12. "count": 62
  13. }
  14. ],
  15. "msgInfo": null,
  16. "errorCode": 0,
  17. "other": null
  18. }

返回参数说明

参数名 参数类型 说明
name string 分类名称(-1,消极;0,中立;1,积极)
count int 舆情数量

十、搜索词接口

1、获取产品搜索词

API功能:获取指定ID的产品相关的搜索词

接口名称:getPrdSearchWord

方法:GET

入参说明

参数名 参数类型 说明 是否必填
productId int 产品ID(通过getProduct接口获取)
timeIntervalType int 时间区间类型,0 最近一天 、1 最近7天 、2 最近30天。 默认是0
sortBy int 排序依据:0 搜索词热度倒排序;1搜索词上升度排序倒排序,默认 0
toPage int 页码(默认是1)
pageSize int 页长(默认是20)

请注意:productId对应的产品名称需包含用户设置的关键词

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "productId": 332632664,
  8. "productName": "Case Cube/果立方 苹果6钢化膜",
  9. "productWordHot": 7786,
  10. "productWordHotDiff": 0.618038,
  11. "searchWord": "苹果6",
  12. "searchWordHot": 2487,
  13. "searchWordHotDiff": 1.179667
  14. },
  15. {
  16. "productId": 332632664,
  17. "productName": "Case Cube/果立方 苹果6钢化膜",
  18. "productWordHot": 7786,
  19. "productWordHotDiff": 0.618038,
  20. "searchWord": "钢化膜",
  21. "searchWordHot": 1815,
  22. "searchWordHotDiff": 0.516291
  23. }
  24. ],
  25. "msgInfo": null,
  26. "errorCode": 0,
  27. "other": null,
  28. "pageSize": 20,
  29. "toPage": 1,
  30. "totalCount": 25,
  31. "totalPages": 2
  32. }

返回参数说明

参数名 参数类型 说明
productName string 产品名称
productId int 产品ID
toPage int 页码(默认是1)
productWordHot int 产品搜索热度
productWordHotDiff double 产品搜索热度上升度
searchWord string 搜索词
searchWordHot string 搜索词热度
searchWordHotDiff string 搜索词热度上升度
pageSize int 页长(默认是20)
totalCount int 总记录数
totalPages int 总页数

2、获取品牌搜索词

API功能:获取指定ID的品牌相关的搜索词

接口名称:getBrandSearchWord

方法:GET

入参说明

参数名 参数类型 说明 是否必填
brandId int 品牌ID(通过getBrand接口获取)
timeIntervalType int 时间区间类型,0 最近24小时 、1 最近7天 、2 最近30天。 默认是0
sortBy int 排序依据:0 搜索词热度倒排序;1搜索词上升度排序倒排序,默认 0
toPage int 页码(默认是1)
pageSize int 页长(默认是20)

请注意:brandId对应的品牌名称需包含用户设置的关键词

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "brandId": 30111,
  8. "brandName": "Apple/苹果",
  9. "brandWordHot": 3280096,
  10. "brandWordHotDiff": -0.081516,
  11. "searchWord": "苹果",
  12. "searchWordHot": 818085,
  13. "searchWordHotDiff": -0.07245
  14. },
  15. {
  16. "brandId": 30111,
  17. "brandName": "Apple/苹果",
  18. "brandWordHot": 3280096,
  19. "brandWordHotDiff": -0.081516,
  20. "searchWord": "iphone",
  21. "searchWordHot": 503220,
  22. "searchWordHotDiff": -0.079143
  23. }
  24. ],
  25. "msgInfo": null,
  26. "errorCode": 0,
  27. "other": null,
  28. "pageSize": 20,
  29. "toPage": 1,
  30. "totalCount": 1693,
  31. "totalPages": 85
  32. }

返回参数说明

参数名 参数类型 说明
brandName string 品牌名称
brandId int 品牌ID
toPage int 页码(默认是1)
brandWordHot int 产品搜索热度
brandWordHotDiff double 产品搜索热度上升度
searchWord string 搜索词
searchWordHot string 搜索词热度
searchWordHotDiff string 搜索词热度上升度
pageSize int 页长(默认是20)
totalCount int 总记录数
totalPages int 总页数

3、获取类目搜索词

API功能:获取指定ID的类目相关的搜索词

接口名称:getCatSearchWord

方法:GET

入参说明

参数名 参数类型 说明 是否必填
categoryId int 类目ID(通过getCat接口获取)
timeIntervalType int 时间区间类型,0 最近24小时 、1 最近7天 、2 最近30天。 默认是0
sortBy int 排序依据:0 搜索词热度倒排序;1搜索词上升度排序倒排序,默认 0
toPage int 页码(默认是1)
pageSize int 页长(默认是20)

请注意:categoryId对应的类目名称需包含用户设置的关键词

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "categoryId": 50018620,
  8. "categoryName": "苹果卡槽",
  9. "categoryWordHot": 16522,
  10. "categoryWordHotDiff": -0.108846,
  11. "searchWord": "卡套",
  12. "searchWordHot": 2509,
  13. "searchWordHotDiff": -0.099749
  14. },
  15. {
  16. "categoryId": 50018620,
  17. "categoryName": "苹果卡槽",
  18. "categoryWordHot": 16522,
  19. "categoryWordHotDiff": -0.108846,
  20. "searchWord": "卡贴",
  21. "searchWordHot": 2004,
  22. "searchWordHotDiff": -0.022916
  23. }
  24. ],
  25. "msgInfo": null,
  26. "errorCode": 0,
  27. "other": null,
  28. "pageSize": 20,
  29. "toPage": 1,
  30. "totalCount": 58,
  31. "totalPages": 3
  32. }

返回参数说明

参数名 参数类型 说明
categoryName string 类目名称
categoryId int 类目ID
toPage int 页码(默认是1)
categoryWordHot int 产品搜索热度
categoryWordHotDiff double 产品搜索热度上升度
searchWord string 搜索词
searchWordHot string 搜索词热度
searchWordHotDiff string 搜索词热度上升度
pageSize int 页长(默认是20)
totalCount int 总记录数
totalPages int 总页数

4、获取搜索词关联词

API功能:获取搜索词关联词

接口名称:getSearchWordNet

方法:GET

入参说明

参数名 参数类型 说明 是否必填
categoryId int 类目ID(通过getCat接口获取)
brandId int 品牌ID(通过getBrand接口获取)
productId int 产品ID(通过getProduct接口获取) 否(以上三个指定一个)
searchWord string 搜索词
toPage int 页码(默认是1)
pageSize int 页长(默认是20)

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "searchWord": "苹果6",
  8. "searchWordHot": 2487,
  9. "relationWord": "钢化膜",
  10. "relationWordCorrelation": 0.349819,
  11. "relationWordHot": 1815,
  12. "relationWordHotDiff": 0.516291
  13. },
  14. {
  15. "searchWord": "苹果6",
  16. "searchWordHot": 2487,
  17. "relationWord": "苹果",
  18. "relationWordCorrelation": -9999,
  19. "relationWordHot": 904,
  20. "relationWordHotDiff": 0.534805
  21. }
  22. ],
  23. "msgInfo": null,
  24. "errorCode": 0,
  25. "other": null,
  26. "pageSize": 20,
  27. "toPage": 1,
  28. "totalCount": 121,
  29. "totalPages": 7
  30. }

返回参数说明

参数名 参数类型 说明
searchWord string 搜索词
searchWordHot int 搜索词热度
relationWord string 关联词
relationWordCorrelation double 关联度
relationWordHot int 关联词热度
relationWordHotDiff double 关联词热度上升度
pageSize int 页长
totalCount int 总记录数
totalPages int 总页数
toPage int 页码

5、获取搜索词原始词

API功能:获取搜索词原始词

接口名称:getOrgSearchWord

方法:GET

入参说明

参数名 参数类型 说明 是否必填
categoryId int 类目ID(通过getCat接口获取)
brandId int 品牌ID(通过getBrand接口获取)
productId int 产品ID(通过getProduct接口获取) 否(以上三个指定一个)
searchWord string 搜索词
toPage int 页码(默认是1)
pageSize int 页长(默认是20)

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "searchWord": "苹果6",
  8. "originalSearchWord": "苹果6s钢化膜",
  9. "originalSearchWordHot": 2,
  10. "originalSearchWordHotDiff": -9999
  11. }
  12. ],
  13. "msgInfo": null,
  14. "errorCode": 0,
  15. "other": null,
  16. "pageSize": 20,
  17. "toPage": 1,
  18. "totalCount": 1,
  19. "totalPages": 1
  20. }

返回参数说明

参数名 参数类型 说明
searchWord string 搜索词
originalSearchWord string 原始词
relationWordCorrelation double 关联度
originalSearchWordHot int 原始词热度
originalSearchWordHotDiff int 原始词热度上升度
pageSize int 页长
totalCount int 总记录数
totalPages int 总页数
toPage int 页码

十一、事件接口

1、获取热门事件

API功能:获取热门事件

接口名称:listHotEvent

方法:GET

入参说明

参数名 参数类型 说明 是否必填
name string 事件名称搜索词
createdAtBegin string 时间创建开始时间(yyyy-MM-dd)
createdAtEnd string 时间创建截止时间(yyyy-MM-dd)
sortBy int 排序依据,0 热度倒排序 、1上升度排序倒排序 (int,默认0)
toPage int 页码(默认是1)
pageSize int 页长(默认是20)

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "eventId": "ebe6def4a455343cc2341630f422c7ad",
  8. "eventName": "关注 | 德媒:中国手机物美价廉瞄准国际市场 三星苹果“要当心”",
  9. "eventDesc": "关注 | 德媒:中国手机物美价廉瞄准国际市场 三星苹果“要当心”",
  10. "brandName": "中国-国际-大学生-雀巢",
  11. "enterpriseName": "",
  12. "eventTime": 1488643200000,
  13. "eventWeight": 4302,
  14. "eventWeightDiff": 1,
  15. "emotionScore": 0
  16. },
  17. {
  18. "eventId": "72d173fbd25081c10a04a6b3d0c1fc9a",
  19. "eventName": "苹果新品发布:中国红iPhone7和7Plus起售价6188元",
  20. "eventDesc": "苹果新品发布:中国红iPhone7和7Plus起售价6188元",
  21. "brandName": "苹果-手机-新品-三星",
  22. "enterpriseName": "",
  23. "eventTime": 1488729600000,
  24. "eventWeight": 1657,
  25. "eventWeightDiff": 1,
  26. "emotionScore": 0
  27. }
  28. ],
  29. "msgInfo": null,
  30. "errorCode": 0,
  31. "other": null,
  32. "pageSize": 20,
  33. "toPage": 1,
  34. "totalCount": 157,
  35. "totalPages": 8
  36. }

返回参数说明

参数名 参数类型 说明
eventId string 时间ID
eventName string 事件名称
eventDesc string 事件描述
brandName string 品牌名称
enterpriseName string 企业名称
eventTime long 事件发生日期(毫秒)
eventWeight int 事件热度
eventWeightDiff double 事件热度上升度
emotionScore double 事件情感值
pageSize int 页长
totalCount int 总记录数
totalPages int 总页数
toPage int 页码

2、获取热门事件属性

API功能:获取热门事件

接口名称:getEventAttr

方法:GET

入参说明

参数名 参数类型 说明 是否必填
eventId string 事件ID

返回示例

  1. {
  2. "success": true,
  3. "messages": [
  4. ""
  5. ],
  6. "errorMessages": [],
  7. "result": {
  8. "eventId": "ebe6def4a455343cc2341630f422c7ad",
  9. "eventName": "关注 | 德媒:中国手机物美价廉瞄准国际市场 三星苹果“要当心”",
  10. "eventDesc": "关注 | 德媒:中国手机物美价廉瞄准国际市场 三星苹果“要当心”",
  11. "brandName": "中国-国际-大学生-雀巢",
  12. "enterpriseName": "",
  13. "eventTime": 1488643200000,
  14. "eventWeight": 4302,
  15. "eventWeightDiff": 1,
  16. "emotionScore": 0,
  17. "relationWordList": [
  18. {
  19. "entity": {
  20. "entity": "单车", # 1、热词
  21. "weight": 0 # 2、热词热度
  22. },
  23. "weight": -0.08156012608614704 # 3、热词热度上升度
  24. },
  25. {
  26. "entity": {
  27. "entity": "政府",
  28. "weight": 0
  29. },
  30. "weight": 0.02820567934958463
  31. }
  32. ],
  33. "countList": [
  34. {
  35. "entity": 4302, # 4、舆情数量
  36. "time": 1488643200000 # 5、日期(毫秒)
  37. }
  38. ],
  39. "emotionScoreList": [
  40. {
  41. "entity": 3.1535997281257075, # 6、情感值
  42. "time": 1488643200000 # 7、日期(毫秒)
  43. }
  44. ]
  45. },
  46. "msgInfo": null,
  47. "errorCode": null,
  48. "other": null
  49. }

返回参数说明

参数名 参数类型 说明
eventId string 时间ID
eventName string 事件名称
eventDesc string 事件描述
brandName string 品牌名称
enterpriseName string 企业名称
eventTime long 事件发生时间(毫秒)
eventWeight int 事件热度
eventWeightDiff double 事件热度上升度
emotionScore double 事件情感值
relationWordList jsonarray 关联词数组
countList jsonarray 舆情数量趋势
emotionScoreList jsonarray 情感值趋势

3、获取热门事件脉络

API功能:取热门事件脉络

接口名称:getEventContext

方法:GET

入参说明

参数名 参数类型 说明 是否必填
eventId string 事件ID

返回示例

  1. {
  2. "success": true,
  3. "messages": [
  4. ""
  5. ],
  6. "errorMessages": [],
  7. "result": [
  8. {
  9. "entity": "2017浙江公务员考试时事新闻:2017年政府工作报告极简版,600字带你看懂 ",
  10. "weight": 1425,
  11. "time": 1488643200000
  12. },
  13. {
  14. "entity": "·北京各区拟划共享单车停车区 管理办法有望年内出台 2017",
  15. "weight": 1338,
  16. "time": 1488729600000
  17. }
  18. ],
  19. "msgInfo": null,
  20. "errorCode": null,
  21. "other": null
  22. }

返回参数说明

参数名 参数类型 说明
entity string 事件脉络描述
weight int 相关舆情数量
time long 对应日期(毫秒)

4、获取事件舆情来源统计信息

API功能:获取事件舆情来源统计信息

接口名称:getEventSourceCount

方法:GET

入参说明

参数名 参数类型 说明 是否必填
eventId string 事件ID
timeIntervalType int 时间区间类型(0-近一天,1-近一周,2-近三十天),默认0

返回示例

  1. {
  2. "success": true,
  3. "messages": [
  4. ""
  5. ],
  6. "errorMessages": [],
  7. "result": [
  8. {
  9. "entity": "21财经搜索",
  10. "count": 9
  11. },
  12. {
  13. "entity": "IT之家",
  14. "count": 15
  15. }
  16. ],
  17. "msgInfo": null,
  18. "errorCode": null,
  19. "other": null
  20. }

返回参数说明

参数名 参数类型 说明
entity string 来源名称
count int 来源包含的舆情量

5、获取事件舆情情感分类统计

API功能:获取事件舆情来源统计信息

接口名称:getEventEmotionCount

方法:GET

入参说明

参数名 参数类型 说明 是否必填
eventId string 事件ID
timeIntervalType int 时间区间类型(0-近一天,1-近一周,2-近三十天),默认0

返回示例

  1. {
  2. "success": true,
  3. "messages": [
  4. ""
  5. ],
  6. "errorMessages": [],
  7. "result": [
  8. {
  9. "entity": "-1",
  10. "count": 50
  11. },
  12. {
  13. "entity": "0",
  14. "count": 4
  15. },
  16. {
  17. "entity": "1",
  18. "count": 4248
  19. }
  20. ],
  21. "msgInfo": null,
  22. "errorCode": null,
  23. "other": null
  24. }

返回参数说明

参数名 参数类型 说明
entity string 情感分类标识:-1,消极;0,中立;1,积极
count int 舆情量

6、获取事件舆情列表

接口功能:获取事件舆情列表

接口名称:listEventFeedback

方法:GET

入参说明

参数名 参数类型 说明 是否必填
eventId string 事件ID
site string 来源站点
createdAtEnd string 舆情创建截止时间
createdAtBegin string 舆情创建开始时间

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "url": "http://mt.sohu.com/20170313/n483225836.shtml",
  8. "createdAt": 1489414434000,
  9. "pubTime": 1489414260000,
  10. "wbVerifiedType": 0,
  11. "emotionTendency": 1,
  12. "emotionScore": 2.857142925262451,
  13. "subject": "携程美食林设立业内首个举报基金",
  14. "description": " [[+_+]]\n 北京商报讯(记者 钱瑜 白帆)携程美食林又有新动作。随着“3.15”的临近,食 品的卫生、安全问题备受消费者关注。为此,携程美食林在3月13日宣布,针对食品安全问题,",
  15. "site": "搜狐"
  16. },
  17. {
  18. "url": "http://mt.sohu.com/20170313/n483225836.shtml",
  19. "createdAt": 1489414434000,
  20. "pubTime": 1489414260000,
  21. "wbVerifiedType": 0,
  22. "emotionTendency": 1,
  23. "emotionScore": 2.857142925262451,
  24. "subject": "携程美食林设立业内首个举报基金",
  25. "description": " [[+_+]]\n 北京商报讯(记者 钱瑜 白帆)携程美食林又有新动作。随着“3.15”的临近,食 品的卫生、安全问题备受消费者关注。为此,携程美食林在3月13日宣布,针对食品安全问题,",
  26. "site": "搜狐"
  27. }
  28. ],
  29. "msgInfo": null,
  30. "errorCode": 0,
  31. "other": null,
  32. "pageSize": 20,
  33. "toPage": 1,
  34. "totalCount": 4302,
  35. "totalPages": 216
  36. }

返回参数说明

参数名 参数类型 说明
url string 舆情原文地址
createdAt long 舆情创建时间(毫秒)
pubTime long 舆情发布时间(毫秒)
wbVerifiedType int 微博认证类型
emotionTendency int 情感分类(-1消极,0中立,1正面)
emotionScore double 情感值
subject string 舆情标题
description string 舆情概述
site string 站点
pageSize int 页长
totalCount int 总记录数
totalPages int 总页数
toPage int 页码

十二、评论接口

1、获取产品

接口功能:根据名称获取评论最热的产品

接口名称:getProduct

方法:GET

入参说明

参数名 参数类型 说明 是否必填
productName string 产品名称搜索词

请注意:productName必须是用户设置的关键词,否则获取不到数据

返回示例

  1. {
  2. "success": true,
  3. "messages": [
  4. ""
  5. ],
  6. "errorMessages": [],
  7. "result": [
  8. {
  9. "productId": 218950390,
  10. "productName": "Apple/苹果 iPhone 6",
  11. "productCommentWeight": 3132,
  12. "productCommentWeightDiff": 0.11063829787234042
  13. },
  14. {
  15. "productId": 332632664,
  16. "productName": "Case Cube/果立方 苹果6钢化膜",
  17. "productCommentWeight": 3083,
  18. "productCommentWeightDiff": 0.19126738794435857
  19. }
  20. ],
  21. "msgInfo": null,
  22. "errorCode": null,
  23. "other": null
  24. }

返回参数说明

参数名 参数类型 说明
productId long 产品ID
productName string 产品名称
productCommentWeight int 产品评论热度
productCommentWeightDiff double 产品评论热度上升度

2、获取品牌

接口功能:根据名称获取评论最热的品牌

接口名称:getBrand

方法:GET

入参说明

参数名 参数类型 说明 是否必填
brandName string 品牌名称搜索词

请注意:brandName必须是用户设置的关键词,否则获取不到数据

返回示例

  1. {
  2. "success": true,
  3. "messages": [
  4. ""
  5. ],
  6. "errorMessages": [],
  7. "result": [
  8. {
  9. "brandId": 30111,
  10. "brandName": "Apple/苹果",
  11. "brandCommentWeight": 15306,
  12. "brandCommentWeightDiff": 0.08753730282790963
  13. },
  14. {
  15. "brandId": 1028900965,
  16. "brandName": "APPLE/苹果(男鞋)",
  17. "brandCommentWeight": 1062,
  18. "brandCommentWeightDiff": 0.11437565582371459
  19. }
  20. ],
  21. "msgInfo": null,
  22. "errorCode": null,
  23. "other": null
  24. }

返回参数说明

参数名 参数类型 说明
brandId long 品牌ID
brandName string 品牌名称
brandCommentWeight int 品牌评论热度
brandCommentWeightDiff double 品牌评论热度上升度

3、获取类目

接口功能:根据名称获取评论最热的类目

接口名称:getCat

方法:GET

入参说明

参数名 参数类型 说明 是否必填
catName string 类目名称搜索词

请注意:catName必须是用户设置的关键词,否则获取不到数据

返回示例

  1. {
  2. "success": true,
  3. "messages": [
  4. ""
  5. ],
  6. "errorMessages": [],
  7. "result": [
  8. {
  9. "catId": 50018620,
  10. "catName": "苹果卡槽",
  11. "catCommentWeight": 876,
  12. "catCommentWeightDiff": 0.09090909090909091
  13. },
  14. {
  15. "catId": 50018608,
  16. "catName": "苹果视频线/转换线",
  17. "catCommentWeight": 761,
  18. "catCommentWeightDiff": 0.013315579227696404
  19. }
  20. ],
  21. "msgInfo": null,
  22. "errorCode": null,
  23. "other": null
  24. }

返回参数说明

参数名 参数类型 说明
catId long 类目ID
catName string 类目名称
catCommentWeight int 类目评论热度
catCommentWeightDiff double 类目评论热度上升度

4、获取产品观点

接口功能:根据产品ID获取产品观点

接口名称:getPrdReview

方法:GET

入参说明

参数名 参数类型 说明 是否必填
productId long 产品ID
timeType int 时间周期类型,0-昨日 1-最近7天 2-最近30天,默认0
sortBy int 排序依据,0 观点热度倒排序 、1观点上升度排序倒排序,默认 0
toPage int 页码,默认1
pageSize int 页长,默认20

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "productName": "Case Cube/果立方 苹果6钢化膜",
  8. "review": "便宜",
  9. "reviewWeight": 84,
  10. "reviewWeightDiff": -0.5307262569832403,
  11. "reviewEmotionTendency": 1,
  12. "reviewEmotionScore": 10,
  13. "productReviewWeight": 268,
  14. "productReviewWeightDiff": -0.4261241970021413
  15. },
  16. {
  17. "productName": "Case Cube/果立方 苹果6钢化膜",
  18. "review": "实惠",
  19. "reviewWeight": 44,
  20. "reviewWeightDiff": -0.34328358208955223,
  21. "reviewEmotionTendency": 1,
  22. "reviewEmotionScore": 10,
  23. "productReviewWeight": 268,
  24. "productReviewWeightDiff": -0.4261241970021413
  25. }
  26. ],
  27. "msgInfo": null,
  28. "errorCode": 0,
  29. "other": null,
  30. "pageSize": 20,
  31. "toPage": 1,
  32. "totalCount": 22,
  33. "totalPages": 2
  34. }

返回参数说明

参数名 参数类型 说明
productName string 产品名称
review string 观点
reviewWeight int 观点热度
reviewWeightDiff double 观点热度上升度
reviewEmotionTendency int 观点情感分类(-1,负面;0,中立;1,正面)
reviewEmotionScore double 观点情感打分
productReviewWeight int 产品热度
productReviewWeightDiff double 产品热度上升度
pageSize int 页长
totalCount int 总记录数
totalPages int 总页数
toPage int 页码

5、获取品牌观点

接口功能:根据品牌ID获取品牌观点

接口名称:getBrandReview

方法:GET

入参说明

参数名 参数类型 说明 是否必填
brandId long 品牌ID
timeType int 时间周期类型,0-昨日 1-最近7天 2-最近30天,默认0
sortBy int 排序依据,0 观点热度倒排序 、1观点上升度排序倒排序,默认 0
toPage int 页码,默认1
pageSize int 页长,默认20

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "brandName": "Apple/苹果",
  8. "review": "是正品",
  9. "reviewWeight": 384,
  10. "reviewWeightDiff": -0.09647058823529411,
  11. "reviewEmotionScore": 10,
  12. "reviewEmotionTendency": 1,
  13. "brandReviewWeight": 1329,
  14. "brandReviewWeightDiff": -0.08218232044198895
  15. },
  16. {
  17. "brandName": "Apple/苹果",
  18. "review": "便宜",
  19. "reviewWeight": 125,
  20. "reviewWeightDiff": 0.02459016393442623,
  21. "reviewEmotionScore": 10,
  22. "reviewEmotionTendency": 1,
  23. "brandReviewWeight": 1329,
  24. "brandReviewWeightDiff": -0.08218232044198895
  25. }
  26. ],
  27. "msgInfo": null,
  28. "errorCode": 0,
  29. "other": null,
  30. "pageSize": 20,
  31. "toPage": 1,
  32. "totalCount": 59,
  33. "totalPages": 3
  34. }

返回参数说明

参数名 参数类型 说明
brandName string 品牌名称
review string 观点
reviewWeight int 观点热度
reviewWeightDiff double 观点热度上升度
reviewEmotionTendency int 观点情感分类(-1,负面;0,中立;1,正面)
reviewEmotionScore double 观点情感打分
brandReviewWeight int 品牌热度
brandReviewWeightDiff double 品牌热度上升度
pageSize int 页长
totalCount int 总记录数
totalPages int 总页数
toPage int 页码

6、获取类目观点

接口功能:根据类目ID获取类目观点

接口名称:getCatReview

方法:GET

入参说明

参数名 参数类型 说明 是否必填
catId long 类目ID
timeType int 时间周期类型,0-昨日 1-最近7天 2-最近30天,默认0
sortBy int 排序依据,0 观点热度倒排序 、1观点上升度排序倒排序,默认 0
toPage int 页码,默认1
pageSize int 页长,默认20

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "catName": "苹果卡槽",
  8. "review": "便宜",
  9. "reviewWeight": 26,
  10. "reviewWeightDiff": -0.10344827586206896,
  11. "reviewEmotionScore": 10,
  12. "reviewEmotionTendency": 1,
  13. "catReviewWeight": 86,
  14. "catReviewWeightDiff": -0.044444444444444446
  15. },
  16. {
  17. "catName": "苹果卡槽",
  18. "review": "实惠",
  19. "reviewWeight": 11,
  20. "reviewWeightDiff": -0.08333333333333333,
  21. "reviewEmotionScore": 10,
  22. "reviewEmotionTendency": 1,
  23. "catReviewWeight": 86,
  24. "catReviewWeightDiff": -0.044444444444444446
  25. }
  26. ],
  27. "msgInfo": null,
  28. "errorCode": 0,
  29. "other": null,
  30. "pageSize": 20,
  31. "toPage": 1,
  32. "totalCount": 17,
  33. "totalPages": 1
  34. }

返回参数说明

参数名 参数类型 说明
catName string 类目名称
review string 观点
reviewWeight int 观点热度
reviewWeightDiff double 观点热度上升度
reviewEmotionTendency int 观点情感分类(-1,负面;0,中立;1,正面)
reviewEmotionScore double 观点情感打分
catReviewWeight int 类目热度
catReviewWeightDiff double 类目热度上升度
pageSize int 页长
totalCount int 总记录数
totalPages int 总页数
toPage int 页码

7、获取评论

接口功能:根据观点和产品、品牌、类目ID获取相关评论

接口名称:getComment

方法:GET

入参说明

参数名 参数类型 说明 是否必填
review string 观点
timeType int 时间周期类型,0-昨日 1-最近7天 2-最近30天,默认0
sortBy int 排序依据,0 观点热度倒排序 、1观点上升度排序倒排序,默认 0
productId long 产品ID
brandId long 品牌ID
catId long 类目ID 否(以上三个指定一个)
toPage int 页码,默认1
pageSize int 页长,默认20

返回示例

  1. {
  2. "success": true,
  3. "messages": [],
  4. "errorMessages": [],
  5. "result": [
  6. {
  7. "comment": "真不错…做的小米粥黏糊糊的…特别好喝",
  8. "commentTime": 1490803200000,
  9. "productId": 702292282,
  10. "productName": "葵花阳光 葵花农场有机黄小米 400g*4",
  11. "brandId": 12918970,
  12. "brandName": "葵花阳光",
  13. "catId": 50009842,
  14. "catName": "小米"
  15. },
  16. {
  17. "comment": "棒棒哒,多次购买了,如实描述,清香的小米味,熬出来的粥稠,很好喝,个人很满意",
  18. "commentTime": 1490803200000,
  19. "productId": 569621706,
  20. "productName": "SeeSang/鲜享 有机黄小米 2.5kg",
  21. "brandId": 118948551,
  22. "brandName": "SeeSang/鲜享",
  23. "catId": 50009842,
  24. "catName": "小米"
  25. }
  26. ],
  27. "msgInfo": null,
  28. "errorCode": 0,
  29. "other": null,
  30. "pageSize": 20,
  31. "toPage": 1,
  32. "totalCount": 23,
  33. "totalPages": 2
  34. }

返回参数说明

参数名 参数类型 说明
comment string 评论内容
commentTime long 评论时间(毫秒)
productId long 产品ID
productName string 产品名称
brandId long 品牌ID
brandName string 品牌名称
catId long 类目ID
catName string 类目名称
pageSize int 页长
totalCount int 总记录数
totalPages int 总页数
toPage int 页码
本文导读目录