API指南__開發者指南_公眾趨勢分析-阿裏雲

一、通用說明

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，表示查詢所有關鍵字專題列表

返回示例

{
    "success":true,
    "errorCode":null,
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":[{
        "id":6542,
        "name":"測試",
        "status":0,
        "createdAt":"2016-04-28T02:01:49.000Z",
        "updatedAt":"2016-04-28T02:12:13.000Z"
    }]
}

返回參數說明

參數名	參數類型	說明
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

返回示例

{
    "success":true,
    "errorCode":null,
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":6543  //成功創建的關鍵字專題主鍵id
}

3、更新關鍵字專題

API功能：對現有關鍵字專題的更新操作，可對關鍵字專題名稱、是否開啟監控狀態這兩個屬性進行修改。

接口名稱：updateTopic

方法：POST

參數：

入參說明

參數名	參數類型	是否必填	說明
id	int	是	關鍵字專題主鍵ID
name	string	是	關鍵字專題名稱
status	int	否	狀態。0:未啟用 1:啟用

返回示例

{
    "success":true,
    "errorCode":null,
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":6543  //關鍵字專題主鍵id
}

4、刪除關鍵字專題

API功能：邏輯刪除一個關鍵字專題。非物理刪除，如果不小心物理刪除，請提工單進行修正。

接口名稱：deleteTopic

方法：POST

參數：

入參說明

參數名	參數類型	是否必填	說明
id	int	是	關鍵字專題主鍵ID

返回示例

{
    "success":true,
    "errorCode":null,
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":6543  //成功刪除的關鍵字專題主鍵id
}

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	印地語

返回示例

{
    "success":true,
    "errorCode":null,
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":[
        {"id":8,"name":"新聞","langType":"ch"},
        {"id":9,"name":"微博","langType":"ch"},
        ....
    ]
}

返回參數說明

參數名	參數類型	說明
id	int	源站類型主鍵ID
name	string	源站類型名稱
langType	string	源站類型語言

四、關鍵字接口

1、查詢關鍵字

API功能：分頁查詢一個關鍵字專題下麵的所有已經添加的關鍵字。

接口名稱：getKeywords

方法：GET

入參說明

參數名	參數類型	是否必填	說明
topicId	int	是	關鍵字專題ID
toPage	int	否	用於分頁查詢。當前頁碼，默認值為:1
pageSize	int	否	用於分頁查詢。每頁顯示條數。默認值為:20。

返回示例

{
    "pageSize":20,                 // 每頁顯示多少
    "toPage":1,                  // 當前頁碼
    "totalCount":1,                  // 一共多少條
    "totalPages":1,                 // 一共多少頁
    "success":true,
    "errorCode":null,
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":[{
        "id":12362,                //關鍵字ID
        "keyword":"杭州 交通事故",         //關鍵字內容
        "topicId":6544,             //關鍵字專題ID
        "createdAt":"2016-04-28T03:09:12.000Z",
        "updatedAt":"2016-04-28T03:09:12.000Z",
        "spiderTopics":[{          
            "id":2252,        //站點組ID，用於輿情搜索時，指定的spiderTopicId
            "name":"新聞"            //站點組名稱
        },{
            "id":2253,
            "name":"微博"
        }]
    }]
}

2、添加關鍵字

API功能：用於向一個關鍵字專題添加關鍵字。一個關鍵字組合內部可用空格表示“AND”的關係，可一次性添加多個關鍵字組合。

接口名稱：createKeyword

方法：POST

入參說明

參數名	參數類型	是否必填	說明
topicId	int	是	關鍵字專題ID
keywords	string/array	是	關鍵字，多個關鍵字請用json數組封裝，如 [“關鍵字1”,”關鍵字2”]
siteTypeIds	int/array	是	關聯的源站類型ID，多個請用json數組封裝，如 [8,9]

返回示例

{
    "success":true,
    "errorCode":null
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":[12363,12364]  // 創建成功的關鍵字ID數組
}

3、刪除關鍵字

API功能：邏輯刪除關鍵字。刪除後，係統將在約20分鍾內生效；20分鍾後，便不會再抓取該詞，但是曆史抓取記錄會被保留。

接口名稱：deleteKeyword

方法：POST

入參說明

參數名	參數類型	是否必填	說明
ids	int/array	是	要刪除的關鍵字ID。如果是多個，請用json數組封裝，如 [12363,12364]

返回示例

{
    "success":true,
    "errorCode":null
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":[12363,12364]  // 刪除成功的關鍵字id數組
}

4、編輯關鍵字（單個）

API功能：用於修改單個關鍵字的屬性。支持對內容、所屬關鍵字專題、抓取的源站類型3個屬性的修改。

接口名稱：updateKeyword

方法：POST

入參說明

參數名	參數類型	是否必填	說明
id	int	是	關鍵字主鍵ID
keyword	string	是	關鍵字內容
topicId	int	否	關鍵字專題ID
siteTypeIds	int/array	否	關聯的源站類型主鍵ID，多個請用json數組封裝，如 [2232,2233]

返回示例

{
    "success":true,
    "errorCode":null
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":[12363]  // 更新成功的關鍵字主鍵ID
}

5、編輯關鍵字（批量）

API功能：用於修改多個關鍵字的屬性。支持對所屬關鍵字專題、抓取的源站類型兩個屬性的修改。

接口名稱：updateKeywords

方法：POST

入參說明

參數名	參數類型	是否必填	說明
ids	int/array	是	關鍵字主鍵ID,多個可用json數組封裝，如 [12363,12364]
topicId	int	否	關鍵字專題ID
siteTypeIds	int/array	否	關聯的源站類型主鍵ID，多個請用json數組封裝，如 [2232,2233]

返回示例

{
    "success":true,
    "errorCode":null
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":[12369,12370]  // 更新成功的關鍵字主鍵ID列表
}

五、輿情數據

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
tab	int	否	輿情列表類別：0:為全部輿情，1：有效輿情，2:新輿情
toPage	int	否	用於分頁查詢。當前頁碼，不傳默認值:1
pageSize	int	否	用於分頁查詢。每頁顯示條數。默認值為:20。

返回示例

{
    "pageSize":20,
    "toPage":20,
    "totalCount":0,
    "totalPages":0,
    "success":true,
    "errorCode":null,
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
        "result":{
            "records":[{
                 "id":11175897,
                 "monitorKeywords":"*",
                 "monitorKeywordId":12359,
                 "monitorTopicId":0,
                 "subject":"《瘋狂動物城》尼克狐的.....",
                 "translateSubject":null,
                 "translateDescription":null,
                 "description":"*文章為作者獨立觀點，不代表虎嗅網立。。。。",
                 "clusterId":11175897,
                 "priority":4,
                 "url":"https://www.huxiu.com/article/147005/1.html?f=index_feed_article",
                 "createdAt":"2016-04-28T04:53:05.000Z",
                 "pubTime":"2016-04-28T04:51:04.000Z",
                 "from":"虎嗅網",
                 "langType":"ch",
                 "filterStatus":1,
                 "wbType":2,
                 "wbFansCount":0,
                 "wbRepostCount":0,
                 "wbCommentCount":0,
                 "wbLikeCount":null,
                 "wbVerifiedType":0,
                 "emotionTendency":-1,
                 "emotionScore":-7
             }],
            "facetFields":null,
            "dateFacetFields":null
        }
}

返回參數說明

參數名	參數類型	說明
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隻用作取消錯誤標記為有效的輿情）

返回示例

{
    "success":true,
    "errorCode":null
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":[11179498]  // 更新成功的輿情主鍵ID
}

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
tab	int	否	輿情列表類別：0:為全部輿情，1：有效輿情，2:新輿情
facetType	string	是	分組展示類型：hot_event:熱門事件，keyword:關鍵字，site:媒體，monitor_topic:關鍵字專題
toPage	int	否	用於分頁查詢。當前頁碼，不傳默認值:1
pageSize	int	否	用於分頁查詢。每頁顯示條數。默認值為:20。

返回示例

{
    "success": true,
    "data": [
        {
            "name": "微信",     //注意，facetType=monitor_topic，返回的name為關鍵字專題ID
            "count": 453
        },
        {
            "name": "和訊網",
            "count": 95
        }
    ]
}

返回參數說明

參數名	參數類型	說明
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等級

返回示例

6、將某輿情放入回收站

API功能：此接口用於過濾指定輿情數據，放入回收站。

接口名稱：setDustbin

方法：POST

入參說明

參數名	參數類型	是否必填	說明
id	Long	是	輿情主鍵ID

返回示例

7、查詢輿情詳情數據

API功能：用於查詢輿情詳情數據

接口名稱：getDetail

方法：GET

入參說明

參數名	參數類型	是否必填	說明
id	Long	是	輿情Id

返回示例

{
    "success": true,
    "errorCode": null,
    "other": null,
    "msgCode": null,
    "msgInfo": null,
    "messages": [],
    "errorMessages": [],
    "messageContext": {},
    "result": {
        "id": 13679723,
        "productId": 13966,
        "spiderTopicId": 1340,
        "monitorKeywords": "11",
        "monitorKeywordId": 103028,
        "from": "和訊網_科技要聞",
        "url": "https://tech.hexun.com/2016-12-13/187322772.html",
        "filterStatus": 0,
        "createdAt": "2016-12-13T08:29:41.517Z",
        "pubTime": "2016-12-13T08:15:00.000Z",
        "wbId": null,
        "wbUserId": null,
        "wbFansCount": 0,
        "wbRepostCount": 0,
        "wbCommentCount": 0,
        "wbLikeCount": 0,
        "wbVerifiedType": 0,
        "wbType": 2,
        "emotionTendency": 1,
        "emotionScore": 30,
        "urlMD5": "f2eba50c3c881f3909ee22deaef9a5de",
        "tags": [],
        "langType": "ch",
        "subject": "民生銀行：史玉柱持股比例增至4.97%",
        "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`   民生銀行：史玉柱持股比例增...",
        "translateSubject": null,
        "translateDescription": null,
        "clusterId": 13679723,
        "priority": 4,
        "source": "News",
        "attachments": [
            {
                "filename": "0000.jpg",
                "url": "0000.jpg"
            }
        ]
    }
}

返回參數說明

參數名	參數類型	說明
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

返回示例

{
    "success":true,
    "errorCode":null
    "other":null,
    "msgCode":null,
    "msgInfo":null,
    "messages":[],
    "result":552  // 生成的微博分析任務主鍵ID。可用此ID查詢分析結果
}

2、查詢微博分析結果

API功能：獲取微博分析的結果。由於分析需要一定的時間，通常為30次轉發/秒，前端可根據此時間進行時間預估。當取得分析結果接口中的data不為null時，表示分析已經完成。

接口名稱：getWeiboAnalysisResult

方法：GET

入參說明

參數名	參數類型	是否必填	說明
id	int	是	微博分析任務主鍵ID

返回示例

分析中(data為null）

{ success: true,
  result: 
   { id: 559,
     weiboUrl: 'https://weibo.com/1622004114/DsAI319Ai?from=page_1006061622004114_profile&wvr=6&mod=weibotime&type=comment',
     uid: null,
     screenName: null,
     content: '#QCon北京2016# 運維專場開場《海量容器係統運維實踐》的講稿實錄，從多Region異地多活,統一接入和安全,Overlay網絡虛擬化,以及應用模型和彈性計算幾個方麵來說如何做高質量架構產品化輸出@QCon全球軟件開發大會 @InfoQ @開發者頭條 @阿裏雲 @阿裏技術嘉年華 https://t.cn/Rq0du7c',
     uInfo: null,
     wInfo: 
      { annotations: '',
        attitudesCount: 3,
        bmiddlePic: '',
        commentsCount: 12,
        createdAt: 1461562476000,
        favorited: false,
        geo: 'null',
        id: '3968142990275174',
        idstr: 3968142990275174,
        inReplyToScreenName: '',
        inReplyToStatusId: -1,
        inReplyToUserId: -1,
        latitude: -1,
        longitude: -1,
        mid: '3968142990275174',
        mlevel: 0,
        originalPic: '',
        picIds: [],
        picUrls: [],
        repostsCount: 35,
        source: [Object],
        text: '#QCon北京2016# 運維專場開場《海量容器係統運維實踐》的講稿實錄，從多Region異地多活,統一接入和安全,Overlay網絡虛擬化,以及應用模型和彈性計算幾個方麵來說如何做高質量架構產品化輸出@QCon全球軟件開發大會 @InfoQ @開發者頭條 @阿裏雲 @阿裏技術嘉年華 https://t.cn/Rq0du7c',
        thumbnailPic: '',
        truncated: false,
        user: [Object],
        visible: [Object] },
     totalFollows: null,
     simpleReport: null,
     detailReport: null,
     data: null,
     graphData: null,
     pubTime: Mon Apr 25 2016 13:34:36 GMT+0800 (CST),
     createdAt: Thu Apr 28 2016 17:32:29 GMT+0800 (CST),
     updatedAt: Thu Apr 28 2016 17:32:29 GMT+0800 (CST) } }

分析後(data不為null）

{ success: true,
  result: 
   { id: 559,
     weiboUrl: 'https://weibo.com/1622004114/DsAI319Ai?from=page_1006061622004114_profile&wvr=6&mod=weibotime&type=comment',
     uid: '1622004114',
     screenName: '淘寶開放平台',
     content: '#QCon北京2016# 運維專場開場《海量容器係統運維實踐》的講稿實錄，從多Region異地多活,統一接入和安全,Overlay網絡虛擬化,以及應用模型和彈性計算幾個方麵來說如何做高質量架構產品化輸出@QCon全球軟件開發大會 @InfoQ @開發者頭條 @阿裏雲 @阿裏技術嘉年華 https://t.cn/Rq0du7c',
     uInfo: 
      { allowAllActMsg: true,
        allowAllComment: false,
        avatarLarge: 'https://tp3.sinaimg.cn/1622004114/180/1284433074/1',
        biFollowersCount: 192,
        city: 1,
        createdAt: 1258688488000,
        description: '淘寶開放平台是將阿裏巴巴內部的商業和能力開放出來，賦能整個商業生態。 進化新商業，開放新思維。 平台動態請關注：https://open.taobao.com 更多官方變更請關注官方公：https://open.taobao.com/support/announcement_list.htm',
        favouritesCount: 1,
        followMe: false,
        followersCount: 38483,
        following: true,
        friendsCount: 247,
        gender: 'm',
        id: '1622004114',
        lang: 'zh-cn',
        location: '浙江 杭州',
        name: '淘寶開放平台',
        onlineStatus: 0,
        profileImageURL: 'https://tp3.sinaimg.cn/1622004114/50/1284433074/1',
        profileImageUrl: 'https://tp3.sinaimg.cn/1622004114/50/1284433074/1',
        province: 33,
        screenName: '淘寶開放平台',
        statusId: '',
        statusesCount: 1764,
        uRL: 'https://open.taobao.com',
        url: 'https://open.taobao.com',
        userDomain: 'opentaobao',
        verified: true,
        verifiedReason: '淘寶開放平台部門官方微博',
        verifiedType: 2,
        verified_reason: '淘寶開放平台部門官方微博',
        weihao: '' },
     wInfo: 
      { annotations: '',
        attitudesCount: 3,
        bmiddlePic: '',
        commentsCount: 12,
        createdAt: 1461562476000,
        favorited: false,
        geo: 'null',
        id: '3968142990275174',
        idstr: 3968142990275174,
        inReplyToScreenName: '',
        inReplyToStatusId: -1,
        inReplyToUserId: -1,
        latitude: -1,
        longitude: -1,
        mid: '3968142990275174',
        mlevel: 0,
        originalPic: '',
        picIds: [],
        picUrls: [],
        repostsCount: 35,
        source: [Object],
        text: '#QCon北京2016# 運維專場開場《海量容器係統運維實踐》的講稿實錄，從多Region異地多活,統一接入和安全,Overlay網絡虛擬化,以及應用模型和彈性計算幾個方麵來說如何做高質量架構產品化輸出@QCon全球軟件開發大會 @InfoQ @開發者頭條 @阿裏雲 @阿裏技術嘉年華 https://t.cn/Rq0du7c',
        thumbnailPic: '',
        truncated: false,
        user: [Object],
        visible: [Object] },
     totalFollows: 38483,
     simpleReport: '消息曝光量<span title="曝光量表示所有轉發用戶的總粉絲數">404536</span>，共計轉發<b>35</b>次，其中一轉<b>17</b>次，二轉<b>16</b>次，三轉<b>1</b>次，北京、浙江、上海地區參與轉發人數較多。用戶情緒指數為<b>99</b>，傳遞了超強的正能量。沒有發現任何疑似水軍。',
     detailReport: null,
     data: 
      { areaMap: [   // 微博轉發地域分析
            { key: '北京', value: 15 },
            { key: '浙江', value: 8 },
            { key: '上海', value: 3 },
            { key: '江蘇', value: 3 },
            { key: '山東', value: 2 },
            { key: '廣東', value: 2 },
            { key: '其他', value: 1 },
            { key: '海外', value: 1 } ],
        emotion: 99,  // 情感值
        levelList: [ 17, 16, 1, 0 ], // 轉發層級分析
        sexMap: { '女': 1, '男': 34 }, // 性別比例
        timeList: [Object], //轉發時間曲線數據
        top100User: [   // 關鍵傳播賬號
             { followersCount: 414,
               friendsCount: 354,
               gender: 'm',
               postTime: 1461581414000,
               repostCount: 6,
               screenName: 'wisdomyu',
               statusMid: '3968222422190527',
               userId: '1428493165',
               verifiedType: '普通用戶' },
             { followersCount: 25352,
               friendsCount: 669,
               gender: 'm',
               postTime: 1461563724000,
               repostCount: 5,
               screenName: '阿裏技術嘉年華',
               statusMid: '3968148225362229',
               userId: '1939498534',
               verifiedType: '企業認證（企業）' },
             { followersCount: 16613,
               friendsCount: 231,
               gender: 'm',
               postTime: 1461564477000,
               repostCount: 4,
               screenName: '阿裏技術保障',
               statusMid: '3968151388144939',
               userId: '3851645388',
               verifiedType: '企業認證（企業）' },
             { followersCount: 957,
               friendsCount: 874,
               gender: 'm',
               postTime: 1461597070000,
               repostCount: 1,
               screenName: '臧秀濤',
               statusMid: '3968288091950552',
               userId: '2710829805',
               verifiedType: '個人認證（名人）' },
             { followersCount: 23384,
               friendsCount: 118,
               gender: 'm',
               postTime: 1461566131000,
               repostCount: 1,
               screenName: '阿裏數據',
               statusMid: '3968158325129144',
               userId: '2414452832',
               verifiedType: '企業認證（企業）' },
             { followersCount: 8531,
               friendsCount: 217,
               gender: 'm',
               postTime: 1461651555000,
               repostCount: 1,
               screenName: 'Docker精選',
               statusMid: '3968516614579106',
               userId: '5360910133',
               verifiedType: '普通用戶' } ],
        totalFollows: 404536,  
        userTypeMap: { '個人認證': 3, '企業認證': 9, '微博達人': 4, '普通用戶': 19 },  // 用戶類型
        waterArmyMap: { false: 35, true: 0 }  // 水軍分析
     },
     graphData: ....., //路徑傳播圖 xml數據
     pubTime: Mon Apr 25 2016 13:34:36 GMT+0800 (CST),
     createdAt: Thu Apr 28 2016 17:32:29 GMT+0800 (CST),
     updatedAt: Thu Apr 28 2016 17:32:32 GMT+0800 (CST) } }

傳播鏈接的展示推薦使用gephi組件。

3、分析一個微博賬號的水軍概率

API功能：通過公眾趨勢分析獨創的水軍分析算法，判斷一個微博賬號的水軍概率。返回結果為0到1之間的一個浮點數，數值越接近1，越有可能是水軍。

接口名稱：getWaterArmyAnalysisResult

方法：GET

入參說明

參數名	參數類型	是否必填	說明
id	int	是	微博用戶ID。在微博URL中可得到

返回示例

{
  "success": true,
  "result": 0.01,
  "messages": []
}

七、首頁報表接口

1、源站類型分析

API功能：查詢某個時間點的不同源站下的輿情數量

接口名稱：queryReportNumber

方法： GET

入參說明

參數名	參數類型	說明	是否必填
keyWordTopicId	int	專題ID，不傳則獲取全部專題的源站類型	否
time	int	時間，如20160121	是
timeType	int	過濾的時間類型，0為當天，1為近七天，2為近30天。不傳則默認為0	否

返回示例

{
  "success": true,
  "messages": [ ],
  "result": [
        {
              "logDate": 20161012,
              "sourceName": "新聞",
              "value": 871
        }]
}

返回參數說明

參數名	參數類型	說明
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	否

返回示例

{
    "success": true,
    "result": {
        "logDate": 20160922,
        "value": 14
    },
    "messages": []
}

返回參數說明

參數名	參數類型	說明
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	否

返回示例

{
"success": true,
"result": {
    "logDate": 20160922,
    "listData": [
        {
            "name": "破土",
            "count": 187
        }],
  "messages": []
}

返回參數說明

參數名	參數類型	說明
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	否

返回示例

{
"success": true,
"result": {
    "logDate": 20160922,
    "listData": [
        {
            "name": "【實時路況】#出行提示#8:30分，虹橋樞紐周邊道路情況（綠色為暢通，...",
            "count": 44
        }
    ]
},
"messages": []
}

返回參數說明

參數名	參數類型	說明
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	否

返回示例

{
"success": true,
"result": {
    "logDate": 20160922,
    "value": 1309
},
"messages": []
}

返回參數說明

參數名	參數類型	說明
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	否

返回示例

{
"success": true,
"result": {
    "logDate": 20160922,
    "listData": [
        {
            "name": "【實時路況】#出行提示#8:30分，虹橋樞紐周邊道路情況（綠色為暢通，...",
            "count": 44
        },
        {
            "name": "10月16日#2016南京馬拉鬆# 比賽期間，江東中路等部分道路分段實...",
            "count": 26
        }
    ]
},
"messages": []
}

返回參數說明

參數名	參數類型	說明
logDate	Date	采集時間。時間格式為UTC時間
listData	list	各關鍵字對應的詳情
listData.name	string	關鍵字名稱
listData.count	int	關鍵字的輿情統計數量

最後更新：2016-12-16 18:31:31

API指南__開發者指南_公眾趨勢分析-阿裏雲

一、通用說明

二、關鍵字專題接口

1、查詢關鍵字專題

2、創建關鍵字專題

3、更新關鍵字專題

4、刪除關鍵字專題

5、開啟/關閉關鍵字專題

三、源站類型

1、查詢源站類型列表

四、關鍵字接口

1、查詢關鍵字

2、添加關鍵字

3、刪除關鍵字

4、編輯關鍵字（單個）

5、編輯關鍵字（批量）

五、輿情數據

2、將某輿情標示為有效

3、熱點事件、關鍵字、媒體、關鍵字專題展示

4、變更某輿情情感

5、修改某輿情的風險等級

6、將某輿情放入回收站

7、查詢輿情詳情數據

六、微博相關接口

1、創建微博分析任務

2、查詢微博分析結果

3、分析一個微博賬號的水軍概率

七、首頁報表接口

1、源站類型分析

2、情感分析

3、熱詞雲

4、熱門事件

5、專題分析

6、關鍵字分析

上一篇：開發者指南___公眾趨勢分析-阿裏雲

下一篇：服務SLA__公眾趨勢分析-阿裏雲

相關內容

熱門內容

最新內容

API指南__開發者指南_公眾趨勢分析-阿裏雲

一、通用說明

二、關鍵字專題接口

1、查詢關鍵字專題

2、創建關鍵字專題

3、更新關鍵字專題

4、刪除關鍵字專題

5、開啟/關閉關鍵字專題

三、源站類型

1、查詢源站類型列表

四、關鍵字接口

1、查詢關鍵字

2、添加關鍵字

3、刪除關鍵字

4、編輯關鍵字（單個）

5、編輯關鍵字（批量）

五、輿情數據

2、將某輿情標示為有效

3、熱點事件、關鍵字、媒體、關鍵字專題展示

4、變更某輿情情感

5、修改某輿情的風險等級

6、將某輿情放入回收站

7、查詢輿情詳情數據

六、微博相關接口

1、創建微博分析任務

2、查詢微博分析結果

3、分析一個微博賬號的水軍概率

七、首頁報表接口

1、源站類型分析

2、情感分析

3、熱詞雲

4、熱門事件

5、專題分析

6、關鍵字分析

上一篇： 開發者指南___公眾趨勢分析-阿裏雲

下一篇： 服務SLA__公眾趨勢分析-阿裏雲

相關內容

熱門內容

最新內容

上一篇：開發者指南___公眾趨勢分析-阿裏雲

下一篇：服務SLA__公眾趨勢分析-阿裏雲