传播分析
更新时间:2019-09-25
创建传播分析订阅任务
创建传播分析订阅任务的方法与创建实时舆情订阅任务的方法相同。
创建时需要将“spread_analysis”的标志置1。
调用API
请求示例:
{
"user_key" : "XXXXXXXXXXX"
"token" : "XXXXXXXXXX"
"timestamp" : 1501647753
"params_dict" : {
"media_type" : ["news","weibo","luntan"],
"history" : 1,
"required_keywords" : ["文明6", "钢铁雄心4"],
"optional_keywords" : [],
"filter_keywords" : [],
"data_source" : [],
"api_dict" : {
"spread_analysis": {
"switch": "1"
},
}
}
}
参数解释:
名称 | 格式 | 必填 | 说明 |
---|---|---|---|
user_key | string | 是 | 申请服务时由百度智能云分配给用户 |
token | string | 是 | token为使用 HMAC 方法生成带有密钥的哈希值,token的生成方法请参看API鉴权认证流程 |
timestamp | int | 是 | 时间戳 |
level | int | 否 | 当使用传播分析API时,level值必须设置为3或不带level参数 |
params_dict | json | 是 | 请求所携带的参数列表 |
params_dict参数解释:
名称 | 格式 | 必填 | 说明 |
---|---|---|---|
media_type | string | 否 | 需要召回和分析的media_type列表,值为一个[]类型的数据。列表可选值为"ps_page", "news", "weibo", "luntan", "boke", "weixin", "all"。,分别代表百度网页搜索结果,新闻,微博,论坛,博客,微信,以及所有。举例:若为["all"]则召回全部媒体类型数据,若为["news","weibo"]则召回新闻和微博数据,若不带该字段,则效果同["all"]。 |
history | int | 否 | 回溯时间,天为单位,取值0,1,7,默认0天 |
required_keywords | string array | 是 | 主监控词列表,如["北京","上海"],多个词用半角,分割 |
optional_keywords | string array | 否 | 搭配词列表,多个词用半角,分割,与主监控词是与的关系 |
filter_keywords | string array | 否 | 过滤词列表,多个词用半角,分割,与主监控词是非的关系 |
data_source | string array | 否 | 目前未用到该字段,使用时直接置为[]即可 |
api_dict | json | 是 | 功能开关 |
api_dict参数解释:
名称 | 格式 | 必填 | 说明 |
---|---|---|---|
spread_analysis | int | 是 | 传播分析,1为打开,0为关闭 |
查看传播分析结果
调用API
-
请求参数配置注意:"api_type"置为“spread_analysis”。
请求示例
{
"user_key" : "XXXXXXXXXXX"
"token" : "XXXXXXXXXX"
"timestamp" : 1501647786
"api_type" : "spread_analysis"
"task_id" : XXXXX
}
请求参数解释:
名称 | 格式 | 必填 | 说明 |
---|---|---|---|
user_key | string | 是 | 申请服务时由百度智能云分配给用户 |
token | string | 是 | token为使用 HMAC 方法生成带有密钥的哈希值,token的生成方法请参看API鉴权认证流程 |
timestamp | int | 是 | 时间戳 |
api_type | string | 是 | 传播分析API对应的值为"spread_analysis" |
task_id | int | 是 | 任务id |
响应示例
由于返回内容较多,完整响应示例请下载附件查看,下载附件。
响应结果分成三个主要结构,如下:
名称 | 说明 |
---|---|
user_graph | 微博转发关系图中的子图列表,字段说明以及图示见下文 |
content_emotion | 内容情感分析结果 |
content_graph | 原创微博转发数据 |
响应参数解释
user_graph参数解释
{
"subgraph_id": 1, //子图id
"subgraph": {
"nodes": [ //子图中的结点信息
{
"user_id": "5688715686", //微博user_id
"appear_time": "2016-11-19 21:19:47", //用户注册时间
"user_type": "ordinary", //用户类型,分为普通,大V等
"followers_count": 72, //粉丝数
"image_url":"http://tp3.sinaimg.cn/5688715686/50/5772983154/0", //头像链接
"user_name": "一颗芯芷为妳" //微博用户名
}
],
"links": [ //用户转发关系,从谁到谁
{
"source": "6039398375", //源用户id
"target": "5032400557", //目标用户id
"retweet_type": "direct", //直接转发还是间接转发
"retweet_step": 1 //中间经过了几次跳转
}
]
},
"subgraph_size": 12 //该子图nodes的个数
}
content_emotion参数解释
名词 | 说明 |
---|---|
positive | 正面列表,列表内容说名见下文(情感项) |
negative | 负面列表,同上 |
neutrality | 中立列表,同上 |
情感项:
{
"user_id": "1803458397",
"weibo_url": "http://weibo.com/1803458397/EiihzeYS5",
"type": "fixed", //fixed代表根微博,非fixed代表不是根微博
"impact_force": 35, //该条微博的影响力
"user_type": "ordinary", //用户类型,分为普通和大V
"followers_count": 232, //粉丝数
"image_url": "http://tp2.sinaimg.cn/1803458397/50/5773196619/1",
"media_type": "weibo",
"date": "2016-11-19 19:01:11", //微博发布时间
"emotion_property": "neutrality", //情感属性
"retweet_count": 1, //转发次数
"user_name": "旦勿日人",
"id": "4043601853570585"
}
content_graph参数解释
[
{
"data": {
"nodes": [
{
"user_id": "3568411162",
"weibo_url": "http://weibo.com/3568411162/EigGrlAdU",
"type": "retweet", //retweet代表转发微博,fixed为根微博
"impact_force": 11, //该条微博影响力
"user_type": "ordinary",
"followers_count": 65,
"image_url": "http://tp3.sinaimg.cn/3568411162/50/5772899213/0",
"media_type": "weibo",
"date": "2016-11-19 14:56:58",
"emotion_property": "neutrality",
"retweet_count": 0, //转发数
"user_name": "小赤佬xy",
"id": "4043540395144134"
}
],
"stat": {
"leaf_followers_count_dis": { //子图粉丝数分布
"0": 15, //传播路径中第0层微博用户粉丝数
"1": 44, //传播路径中第1层微博用户粉丝数
"2": 194,
"3": 29,
"4": 2
},
"importance_user": [ //重要微博结点列表
{
"user_id": "5241346591",
"weibo_url": "http://weibo.com/5241346591/EiAynz1dc",
"type": "retweet",
"impact_force": 62,
"user_type": "ordinary",
"followers_count": 221,
"image_url": "http://tp4.sinaimg.cn/5241346591/50/5773577892/0",
"media_type": "weibo",
"date": "2016-11-21 17:32:03",
"emotion_property": "neutrality",
"retweet_count": 266,
"user_name": "大娃有大头",
"id": "4044304198346142"
}
],
"retweet_time_dis": [ //各datetime时间点转发数分布
{
"num": 122,
"datetime": "2016-11-19 14:00:00"
},
{
"num": 335,
"datetime": "2016-11-19 15:00:00"
}
],
"user_total_num": 5912, //总微博用户数
"weibo_total_num": 5911, //覆盖的微博数
"followers_count_dis": { //粉丝分布
"0": 1101,
"1": 1012,
"2": 2451,
"3": 816,
"4": 532
},
"hierarchy_stat": { //传播路径中第1层第2层第3层第4层转发总数,可能还有5,具体有几层根据结果动态生成
"1": 233,
"2": 3464,
"3": 1517,
"4": 697
},
"user_type_ratio": { //用户类型分布
"ordinary": 5897, //普通用户个数
"BigV": 15 //大V用户个数
}
},
"links": [
{
"source": "4043561676169518",
"target": "4043567598801693"
}
]
},
"root": "4044321081124475" //该子图的根用户id
}
]