C/2/friendships/followers/active num

跳转到: 导航, 搜索
(以“{{Api_desc_business| uri=friendships/followers/biz| desc=获取当前登录用户的粉丝列表。| httpMethod=GET| needAuth=是| rateLimit={{B_rate_limit}}| params...”为内容创建页面)
 
 
(未显示1个用户的4个中间版本)
第1行: 第1行:
 
{{Api_desc_business|
 
{{Api_desc_business|
uri=friendships/followers/biz|
+
uri=friendships/followers/active_num|
desc=获取当前登录用户的粉丝列表。|
+
desc=指定日期用户活跃粉丝数。|
 
httpMethod=GET|
 
httpMethod=GET|
 
needAuth=是|
 
needAuth=是|
 
rateLimit={{B_rate_limit}}|
 
rateLimit={{B_rate_limit}}|
params={{api_args|gender|false|string|指定接收用户的性别范围,m:男、f:女。}}
+
params={{api_args|uid|true|string|指定用户uid。}}
{{api_args|province|false|int|指定接收用户的省份范围,省份ID。}}
+
{{api_args|sdate|false|int|开始时间。}}
{{api_args|city|false|int|指定接收用户的城市范围,城市ID。}}
+
{{api_args|edate|false|int|结束时间。}}|
{{api_args|age|false|string|指定接收用户的年龄范围,取值内容为:6-12、13-18、19-22、23-25、26-29、30-39、40-59、60-80、其他。}}
+
{{api_args|type|false|int|指定粉丝的认证类型。0:所有用户;1:普通用户;2:黄V;4:蓝v(包括政府,企业,媒体,网站,校园,应用,机构/团体,公益组织);8:达人;支持任意数字叠加值,如,6:黄V+蓝V,默认为所有用户。}}
+
<!--{{api_args|flag|false|int|指定粉丝的属性条件。0:所有粉丝;1:活跃粉丝;2:互动粉丝;支持任意数字叠加值,如,3:活跃粉丝+互动粉丝,默认为0。}}-->
+
{{api_args|bucket|false|int|筛选粉丝的个数范围,默认为50,最大不超过200。}}
+
{{api_args|max_time|false|string|返回结果的时间戳游标,若指定此参数,则返回关注时间小于或等于max_time的粉丝,默认从当前时间开始算。返回结果中会得到next_cursor字段,表示下一页的max_time。next_cursor为0表示已经到记录末尾。}}
+
{{api_args|cursor_uid|false|int|排重ID,传上次获取时最后一个用户ID。}}
+
<!--{{api_args|limit|false|int|内部使用的参数,用于限制开发者获取最新粉丝的个数。若指定该参数值为N,表示只能获取最新N个粉丝,N个之前的粉丝无法获取;不指定,表示可以获取全量粉丝。}}-->|
+
 
result=
 
result=
 
<pre>
 
<pre>
 
//成功返回
 
//成功返回
 
{
 
{
    "users": [
+
  errno: 1,
        {
+
  msg: "成功",
            "id": 321205008,
+
  code: "B00001",
            "idstr": "321205008",
+
  result: {
            "screen_name": "江湖社***",
+
      total_fans_num: {
            "name": "江湖社***,
+
          2019-04-14: "0",
            "province": "41",
+
          2019-04-15: "0"
            "city": "1",
+
            "location": "河南 郑州",
+
            "description": "描述。。。",
+
            "url": "http://www.weibo.com",
+
            "profile_image_url": "http://tp2.sinaimg.cn/321205008/50/5652109562/1",
+
            "profile_url": "523438876",
+
            "domain": "laijianghu",
+
            "weihao": "523438876",
+
            "gender": "m",
+
            "followers_count": 270,
+
            "friends_count": 364,
+
            "statuses_count": 23,
+
            "favourites_count": 0,
+
            "created_at": "Wed Jan 02 23:56:03 +0800 2013",
+
            "following": false,
+
            "allow_all_act_msg": true,
+
            "geo_enabled": true,
+
            "verified": false,
+
            "verified_type": -1,
+
            "remark": "",
+
            "status_id": 3532859991713507,
+
            "allow_all_comment": true,
+
            "avatar_large": "http://tp2.sinaimg.cn/3212050081/180/5652109562/1",
+
            "verified_reason": "",
+
            "follow_me": false,
+
            "online_status": 0,
+
            "bi_followers_count": 204,
+
            "lang": "zh-cn",
+
            "star": 0,
+
            "mbtype": 0,
+
            "mbrank": 0,
+
            "block_word": 0
+
 
         },
 
         },
        ...
+
      active_fans: {
    ],
+
          2019-04-14: "895",
    "next_cursor": 1,
+
          2019-04-15: "897"
    "previous_cursor": 0,
+
        },
    "cursor_uid":2903271035,
+
      loyal_fans: {
    "total_number": 61550
+
          2019-04-14: "0",
 +
          2019-04-15: "0"
 +
        },
 +
      total_fans_num_online: {
 +
          2019-04-14: "0",
 +
          2019-04-15: "0"
 +
        }
 +
    }
 
}
 
}
  
//失败返回
 
{
 
    "request": "/friendships/followers/biz.json",
 
    "error_code": XXXXX,
 
    "error": "error message."
 
}
 
 
</pre>|
 
</pre>|
 
resultDes=无|
 
resultDes=无|
useAge=*只能获取当前登录用户的粉丝列表;
+
useAge=*只能获取蓝v用户的活跃粉丝数|
*活跃粉丝是指近30天内有登录的粉丝;
+
*互动粉丝是指近30天内有交互(评论、转发)的粉丝;|
+
 
otherInfo=无
 
otherInfo=无
 
}}{{#a:showgrade}}
 
}}{{#a:showgrade}}

2019年4月25日 (四) 18:07的最后版本

friendships/followers/active_num

指定日期用户活跃粉丝数。

URL

https://c.api.weibo.com/2/friendships/followers/active_num.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制


请求所有商业接口:

    • 50000次/小时/IP;

请求参数

  必选 类型及范围 说明
source false string 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。
access_token false string 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。
uid true string 指定用户uid。
sdate false int 开始时间。
edate false int 结束时间。

注意事项

  • 只能获取蓝v用户的活跃粉丝数

返回结果

JSON示例

//成功返回
{
   errno: 1,
   msg: "成功",
   code: "B00001",
   result: {
       total_fans_num: {
           2019-04-14: "0",
           2019-04-15: "0"
        },
       active_fans: {
           2019-04-14: "895",
           2019-04-15: "897"
        },
       loyal_fans: {
           2019-04-14: "0",
           2019-04-15: "0"
        },
       total_fans_num_online: {
           2019-04-14: "0",
           2019-04-15: "0"
        }
    }
}


关于错误返回值与错误代码,参见 错误代码说明

字段说明

其他



Language: [[{{{2/uri}}}|中文]]


文档更新时间: 2019-04-25
api评价