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;

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 The keywords that you want to search, it cannot include special symbols such as '{','}'.
ids false string The user ids that you want to search, multuple user ids are should be seperated by '~', the total number of users cannot exceed 50.
province false int The province id that you want to search, please refer to our province and city code sheet.
city false int The city id that you want to search, please refer to our province and city code sheet.
sort false string Type of sort,time:by time、hot:by content polularity、fwnum:by repost count in reverse order、cmtnum:by comment count in reverse order, time is the default type.
starttime false int The start time you would specify.
endtime false int The end time you would specify.
hasori false int Whether to include the original post, 0:not include the original post, 1:only include the original post. In defalut, all posts are included.
hasret false int Whether to include repost, 0:not include repost, 1:only include repost. In defalut, all posts are included.
hastext false int Whether to include pure text , 0:not include pure text, 1:only include pure text. In defalut, all posts are included.
haspic false int
hasvideo false int Whether to include video , 0:not include video, 1:only include video. In defalut, all posts are included.
hasmusic false int Whether to include music , 0:not include music, 1:only include music. In defalut, all posts are included.
haslink false int Whether to include link , 0:not include link, 1:only include link. In defalut, all posts are included.
hasat false int Whether to include symbol '@' , 0:not include '@', 1:only include '@'. In defalut, all posts are included.
hasv false int Whether the content is published by v users , 0:no 1:yes. In defalut, all posts are included.
istag false int Whether to precisely search topics between ##, 0: no(default) 1:fuzzy matching 2: precise matching.
dup false int Whether to remove duplicated posts, 0: no, 1: yes(default).
antispam false int Whether to spam, 0: no, 1:yes (default).
page false int page number, default is 1.
count false int The post count of a page, minimum is 10 (default), maximum is 50.
base_app false int Whether only to retrieve data from the existing application, 0: no (seach all data, in default), 1: yes (only search the existing app data)

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
  • 与、或、非的关键词不能包含除字母、数字外的其他特殊符号;



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


api评价