跳转到: 导航, 搜索

search/topics

搜索某一话题下的微博

URL

https://api.weibo.com/2/search/topics.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录


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

访问授权限制

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

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
q true string 搜索的话题关键字,必须进行URLencode,utf-8编码。
count false int 单页返回的记录条数,默认为10,最大为50。
page false int 返回结果的页码,默认为1。

注意事项

  • 关键词只能为两#间的话题,即只能搜索某话题下的微博
  • 只返回最新200条结果

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "statuses": [
        {
            "created_at": "Fri Feb 24 15:18:31 +0800 2012",
            "id": 3416614810943471,
            "mid": "3416614810943471",
            "idstr": "3416614810943471",
            "text": "与大家分享我所喜爱的照片!#ABC晒新年# 。",
            "source": "微活动</a>",
            "favorited": false,
            "truncated": false,
            "in_reply_to_status_id": "",
            "in_reply_to_user_id": "",
            "in_reply_to_screen_name": "",
            "thumbnail_pic": "http://ww3.sinaimg.cn/thumbnail/5f0eb04atw1dq4ir5bztkj.jpg",
            "bmiddle_pic": "http://ww3.sinaimg.cn/bmiddle/5f0eb04atw1dq4ir5bztkj.jpg",
            "original_pic": "http://ww3.sinaimg.cn/large/5f0eb04atw1dq4ir5bztkj.jpg",
            "geo": null,
            "user": {
                "id": 1594798154,
                "idstr": "1594798154",
                "screen_name": "刘麦",
                "name": "刘麦",
                "province": "34",
                "city": "16",
                "location": "安徽 亳州",
                "description": "新一代世界小童星。",
                "url": "http://blog.sina.com.cn/liumaiduo",
                "profile_image_url": "http://tp3.sinaimg.cn/1594798154/50/5614782838/1",
                "profile_url": "liumaiduo",
                "domain": "liumaiduo",
                "weihao": "",
                "gender": "m",
                "followers_count": 314,
                "friends_count": 555,
                "statuses_count": 1913,
                "favourites_count": 1,
                "created_at": "Sat Jun 11 00:00:00 +0800 2011",
                "following": false,
                "allow_all_act_msg": false,
                "geo_enabled": true,
                "verified": false,
                "verified_type": -1,
                "allow_all_comment": false,
                "avatar_large": "http://tp3.sinaimg.cn/1594798154/180/5614782838/1",
                "verified_reason": "",
                "follow_me": false,
                "online_status": 1,
                "bi_followers_count": 290,
                "lang": "zh-cn"
            },
            "annotations": [...],
            "reposts_count": 0,
            "comments_count": 0,
            "mlevel": 0,
            "visible": {
                "type": 0,
                "list_id": 0
            }
        },
        ...
    ],
    "total_number": 2543821
}

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

返回字段说明

返回值字段 字段类型 字段说明
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}}}|中文]]




文档更新时间: 2012-11-16
api评价