C/2/search/statuses/limited-en
search/statuses/limited
search for posts containing a certain keyword.
URL
https://c.api.weibo.com/2/search/statuses/limited.json
Supported Formats
JSON
HTTP Request Method
GET
Login Requirement
true
See Login and Authorization for details.
Authorized Access Limitation
Request for all the business API:
- 50000 times per hour per IP;
- 50000 times per hour per IP;
Request Parameters
| Requires | Type and Range | Description | |
|---|---|---|---|
| source | false | string | This parameter is not needed when using OAuth, and is required when using other authorization methods. The value of this parameter is AppKey. |
| access_token | false | string | This parameter is required when using OAuth, and is not needed when using other authorization methods. You will get the access_token after obtaining OAuth. |
| q | false | string | 搜索的关键字( 不能包含{、}、“ 等特殊字符)。必须进行URLencode。 |
| ids | false | string | 搜索指定批量用户的微博，传用户UID，多个用~分隔，最多不超过50个。 |
| province | false | int | 搜索的省份ID，参考省份城市编码表，参数q为空表示搜索这个省份的所有微博。 |
| city | false | int | 搜索的城市ID，参考省份城市编码表，参数q为空表示搜索这个城市的所有微博。 |
| sort | false | string | 排序方式，time：时间倒序、hot：热门度、fwnum：按转发数倒序、cmtnum：评论数倒序，默认为time。 |
| starttime | false | int | 搜索范围起始时间，取值为时间戳，单位为秒。 |
| endtime | false | int | 搜索范围结束时间，取值为时间戳，单位为秒。 |
| hasori | false | int | 是否包含原创，0：不包含原创、1：只包含原创，默认为空（全部）。 |
| hasret | false | int | 是否包含转发，0：不包含转发、1：只包含转发，默认为空（全部）。 |
| hastext | false | int | 是否包含纯文本，0：不包含纯文本、1：只包含纯文本，默认为空（全部）。 |
| haspic | false | int | 是否包含图片，0：不包含图片、1：只包含图片，默认为空（全部）。 |
| hasvideo | false | int | 是否包含视频，0：不包含视频、1：只包含视频，默认为空（全部）。 |
| hasmusic | false | int | 是否包含音乐，0：不包含音乐、1：只包含音乐，默认为空（全部）。 |
| haslink | false | int | 是否包含链接，0：不包含链接、1：只包含链接，默认为空（全部）。 |
| hasat | false | int | 是否包含@，0：不包含@、1：只包含@，默认为空（全部）。 |
| hasv | false | int | 是否为v用户发言，0：否、1：是，默认为空（全部）。 |
| istag | false | int | 是否严格为搜##内的话题，0：否、1：##内模糊匹配、2：##内精确匹配，默认为0。 |
| dup | false | int | 是否排重（不显示相似数据），0：否、1：是，默认为1。 |
| antispam | false | int | 是否反垃圾（不显示低质量数据），0：否、1：是，默认为1。 |
| page | false | int | 页码，默认为1。 |
| count | false | int | 每页返回的数量，最小10，最大50。（默认返回10条） |
| base_app | false | int | 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 |
Notes
- sort参数值fwnum, cmtnum, hot 都只对近期原创微博有效。若返回的是转发微博，则sort为这三种排序时无数据返回；
- 参数province、city指发微博的IP所在的省、市；
- 指定city时，一定要指定province；
- 参数q、ids、province必传其一；
Response
JSON Example
{
"statuses": [
{
"created_at": "Tue May 31 17:46:55 +0800 2011",
"id": 11488058246,
"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,
"mid": "5612814510546515491",
"reposts_count": 8,
"comments_count": 9,
"annotations": [],
"user": {
"id": 1404376560,
"screen_name": "zaku",
"name": "zaku",
"province": "11",
"city": "5",
"location": "北京 朝阳区",
"description": "人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。",
"url": "http://blog.sina.com.cn/zaku",
"profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1",
"domain": "zaku",
"gender": "m",
"followers_count": 1204,
"friends_count": 447,
"statuses_count": 2908,
"favourites_count": 0,
"created_at": "Fri Aug 28 00:00:00 +0800 2009",
"following": false,
"allow_all_act_msg": false,
"remark": "",
"geo_enabled": true,
"verified": false,
"allow_all_comment": true,
"avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1",
"verified_reason": "",
"follow_me": false,
"online_status": 0,
"bi_followers_count": 215
}
},
...
],
"total_number": 16
}
Please see Error Code Description for details of error information.
Field Description
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| 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 |
Others
- 关键词内容支持与、或、非。最好是5个词以内，并且最好一次使用一种语法；
- 与：空格即可，如A B
- 或：~表示，如A~B~C
- 非：空格-，比如A -B，表示出现A,不出现B
- 混用情况：(A B)~(C D)表示同时出现A,B或同时出现C,D， A B -C表示同时出现A,B但不出现C
- 与、或、非的关键词不能包含除字母、数字外的其他特殊符号；
