跳转到: 导航, 搜索

statuses/to_me

获取当前登录用户关注的人发给其的定向微博

URL

https://api.weibo.com/2/statuses/to_me.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录


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

访问授权限制

访问级别:高级接口(需要授权)
频次限制:
关于频次限制,参见 接口访问权限说明

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
since_id false int64 若指定此参数,则返回ID比since_id大的微博(即比since_id时间晚的微博),默认为0。
max_id false int64 若指定此参数,则返回ID小于或等于max_id的微博,默认为0。
page false int 返回结果的页码,默认为1。
count false int 返回结果的条数数量,最大不超过200,默认为20。
trim_user false int 返回值中user字段开关,0:返回完整user字段、1:user字段仅返回uid,默认为0。

注意事项

  • A与B互相关注,B在A的分组G中,A发送定向微博S到G,则,在B的【发给我的微博中】会包括S这条微博;

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "statuses": [
        {
            "created_at": "Wed Oct 24 10:13:08 +0800 2012",
            "id": 3504598209315671,
            "mid": "3504598209315671",
            "idstr": "3504598209315671",
            "text": "这是一条定向微博。",
            "source": "<a href=\"http://weibo.com/\" rel=\"nofollow\">新浪微博</a>",
            "favorited": false,
            "truncated": false,
            "in_reply_to_status_id": "",
            "in_reply_to_user_id": "",
            "in_reply_to_screen_name": "",
            "geo": null,
            "user": {
                "id": 1727194533,
                "idstr": "1727194533",
                "screen_name": "xiao88",
                "name": "xiao88",
                "province": "11",
                "city": "8",
                "location": "北京 海淀区",
                "description": "自由,专注,真诚",
                "url": "",
                "profile_image_url": "http://tp4.sinaimg.cn/1727194533/50/5615937928/1",
                "cover_image": "http://ww1.sinaimg.cn/crop.jpg",
                "profile_url": "xiao88",
                "domain": "xiao88",
                "weihao": "208260000",
                "gender": "m",
                "followers_count": 1308,
                "friends_count": 227,
                "statuses_count": 2361,
                "favourites_count": 58,
                "created_at": "Thu Apr 08 22:49:12 +0800 2010",
                "following": true,
                "allow_all_act_msg": false,
                "geo_enabled": true,
                "verified": false,
                "verified_type": 220,
                "remark": "这是张三",
                "allow_all_comment": true,
                "avatar_large": "http://tp4.sinaimg.cn/1727194533/180/5615937928/1",
                "verified_reason": "",
                "follow_me": true,
                "online_status": 1,
                "bi_followers_count": 160,
                "lang": "zh-cn"
            },
            "reposts_count": 0,
            "comments_count": 2,
            "attitudes_count": 0,
            "mlevel": 0,
            "visible": {
                "type": 3,
                "list_id": 3414069107510258
            }
        }
    ],
    "hasvisible": false,
    "previous_cursor": 0,
    "next_cursor": 3504560314036350,
    "total_number": 101
}

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

返回字段说明

返回值字段 字段类型 字段说明
created_at string 微博创建时间
id int64 微博ID
mid int64 微博MID
idstr string 字符串型的微博ID
text string 微博信息内容
source string 微博来源
favorited boolean 是否已收藏,true:是,false:否
truncated boolean 是否被截断,true:是,false:否
in_reply_to_status_id string (暂未支持)回复ID
in_reply_to_user_id string (暂未支持)回复人UID
in_reply_to_screen_name string (暂未支持)回复人昵称
thumbnail_pic string 缩略图片地址,没有时不返回此字段
bmiddle_pic string 中等尺寸图片地址,没有时不返回此字段
original_pic string 原始图片地址,没有时不返回此字段
geo object 地理信息字段 详细
user object 微博作者的用户信息字段 详细
retweeted_status object 被转发的原微博信息字段,当该微博为转发微博时返回 详细
reposts_count int 转发数
comments_count int 评论数
attitudes_count int 表态数
mlevel int 暂未支持
visible object 微博的可见性及指定可见分组信息。该object中type取值,0:普通微博,1:私密微博,3:指定分组微博,4:密友微博;list_id为分组的组号
pic_ids object 微博配图ID。多图时返回多图ID,用来拼接图片url。用返回字段thumbnail_pic的地址配上该返回字段的图片ID,即可得到多个图片url。
ad object array 微博流内的推广微博ID

其他

相关问题


帮助中心 查看更多问题或提问


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




api评价