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条结果
调用样例及调试工具
返回结果
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 |
其他
无
相关问题
到 帮助中心 查看更多问题或提问
文档更新时间: 2012-11-16
