bShare數據API-幫助|中文互聯網最強大的分享按鈕和分享工具

bShare Analytics API 提供了bShare Pro會員可編程的分享數據訪問服務。

請求鏈接

http://api.bshare.cn/analytics/<publisherUUID>/<metric>.json[?dateStart=<dateStart>][&dateEnd=<dateEnd>][&locale=<locale>][&url=<url>]

請求方法

GET

認證方法

需要通過HTTP BASIC Authentication方式進行認證。使用該UUID所有者在bShare網站的帳號和密碼即可。

路徑參數

以下所有的路徑參數都為必需

publisherUUID

您需要獲取統計數據的站點的publisher UUID.

metric

Metrics說明：

platform: 返回前10位的分享平臺數據。包括分享總數和平臺名稱。
platform_b: 返回前10位的分享平臺數據。包括回流總數和平臺名稱。
stats: 返回點擊數、分享數和回流數及日期。
click: 返回點擊數和日期。
share: 返回分享數和日期。
clickback: 返回回流數和日期。

查詢參數

所有的查詢參數都為可選。請注意：如果您未設置該參數，我們將按照下面羅列出的默認值提供查詢結果。

dateStart	您想查詢數據的起始日期(含該日)。該日期值必須為以下格式: yyyy-mm-dd. 如果沒有設置該值或者被設定為無效的值， dateStart將默認為今天。
dateEnd	您想查詢數據的終止日期(含該日)。該日期必須為以下格式: yyyy-mm-dd. 如果沒有設置該值或者被設定為無效的值, dateEnd將默認為dateStart之前7天.
url	使用此參數來查詢指定頁面的數據，注意頁面url必須是完全匹配，並且此頁面必須屬於當前站長。
locale	返回數據的語言?？墒褂玫闹涤?zh \| zh_TW \| en。如果沒有設置該值或者設定為無效的值，locale將默認為中文(zh).

請求限制

所有的API限制請求數為1000次/每小時。

請求返回

如果出錯，返回對應的HTTP狀態碼及錯誤信息；否則，HTTP狀態碼為200，並返回JSON格式的數據。

請求的metric為platform:

{"analytics":[
{"count":"2","metric":"Renren"},
{"count":"1","metric":"Delicious"}
]}

請求的metric為platform_b:

{"analytics":[
{"count":"3","metric":"Renren"},
{"count":"6","metric":"Delicious"}
]}

請求的metric為share/click/clickback:

{"analytics":[
{"count":"4","metric":"2010-07-07"},
{"count":"2","metric":"2010-07-08"}
]}

請求的metric為stats:

{"analytics":[
{"clicks":"2", "shares":"3", "clickbacks":"4", "date":"2010-07-07"},
{"clicks":"1", "shares":"2", "clickbacks":"3", "date":"2010-07-08"}
]}