C/2/search/statuses/limited-en

跳转到: 导航, 搜索
第6行: 第6行:
 
rateLimit={{B_rate_limit-en}}|
 
rateLimit={{B_rate_limit-en}}|
 
params=
 
params=
{{api_args|q|false|string|搜索的关键字( 不能包含{}、“ 等特殊字符)。必须进行URLencode。}}
+
{{api_args|q|false|string|The keywords that you want to search, it cannot include special symbols such as '{','}'.}}
{{api_args|ids|false|string|搜索指定批量用户的微博,传用户UID,多个用~分隔,最多不超过50个。}}
+
{{api_args|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. }}
{{api_args|province|false|int|搜索的省份ID,参考省份城市编码表,参数q为空表示搜索这个省份的所有微博。}}
+
{{api_args|province|false|int|The province id that you want to search, please refer to our province and city code sheet. }}
{{api_args|city|false|int|搜索的城市ID,参考省份城市编码表,参数q为空表示搜索这个城市的所有微博。}}
+
{{api_args|city|false|int|The city id that you want to search, please refer to our province and city code sheet. }}
{{api_args|sort|false|string|排序方式,time:时间倒序、hot:热门度、fwnum:按转发数倒序、cmtnum:评论数倒序,默认为time。}}
+
{{api_args|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. }}
{{api_args|starttime|false|int|搜索范围起始时间,取值为时间戳,单位为秒。}}
+
{{api_args|starttime|false|int|The start time you would specify. }}
{{api_args|endtime|false|int|搜索范围结束时间,取值为时间戳,单位为秒。}}
+
{{api_args|endtime|false|int|The end time you would specify. }}
{{api_args|hasori|false|int|是否包含原创,0:不包含原创、1:只包含原创,默认为空(全部)。}}
+
{{api_args|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. }}
{{api_args|hasret|false|int|是否包含转发,0:不包含转发、1:只包含转发,默认为空(全部)。}}
+
{{api_args|hasret|false|int|Whether to include repost, 0:not include repost, 1:only include repost. In defalut, all posts are included. }}
{{api_args|hastext|false|int|是否包含纯文本,0:不包含纯文本、1:只包含纯文本,默认为空(全部)。}}
+
{{api_args|hastext|false|int|Whether to include pure text , 0:not include pure text, 1:only include pure text. In defalut, all posts are included. }}
{{api_args|haspic|false|int|是否包含图片,0:不包含图片、1:只包含图片,默认为空(全部)。}}
+
{{api_args|haspic|false|int||Whether to include picture , 0:not include picture, 1:only include picture. In defalut, all posts are included.}}
{{api_args|hasvideo|false|int|是否包含视频,0:不包含视频、1:只包含视频,默认为空(全部)。}}
+
{{api_args|hasvideo|false|int|Whether to include video , 0:not include video, 1:only include video. In defalut, all posts are included.}}
{{api_args|hasmusic|false|int|是否包含音乐,0:不包含音乐、1:只包含音乐,默认为空(全部)。}}
+
{{api_args|hasmusic|false|int|Whether to include music , 0:not include music, 1:only include music. In defalut, all posts are included.}}
{{api_args|haslink|false|int|是否包含链接,0:不包含链接、1:只包含链接,默认为空(全部)。}}
+
{{api_args|haslink|false|int|Whether to include link , 0:not include link, 1:only include link. In defalut, all posts are included.}}
{{api_args|hasat|false|int|是否包含@,0:不包含@、1:只包含@,默认为空(全部)。}}
+
{{api_args|hasat|false|int|Whether to include symbol '@' , 0:not include '@', 1:only include  '@'. In defalut, all posts are included.}}
{{api_args|hasv|false|int|是否为v用户发言,0:否、1:是,默认为空(全部)。}}
+
{{api_args|hasv|false|int|Whether the content is published by v users , 0:no 1:yes. In defalut, all posts are included.}}
{{api_args|istag|false|int|是否严格为搜##内的话题,0:否、1:##内模糊匹配、2:##内精确匹配,默认为0。}}
+
{{api_args|istag|false|int|Whether to precisely search topics between ##, 0: no(default) 1:fuzzy matching 2: precise matching. }}
{{api_args|dup|false|int|是否排重(不显示相似数据),0:否、1:是,默认为1。}}
+
{{api_args|dup|false|int|Whether to remove duplicated posts, 0: no, 1: yes(default).}}
{{api_args|antispam|false|int|是否反垃圾(不显示低质量数据),0:否、1:是,默认为1。}}
+
{{api_args|antispam|false|int|Whether to spam, 0: no, 1:yes (default).}}
{{api_args|page|false|int|页码,默认为1。}}
+
{{api_args|page|false|int|page number, default is 1.}}
{{api_args|count|false|int|每页返回的数量,最小10,最大50。(默认返回10条)}}
+
{{api_args|count|false|int|The post count of a page, minimum is 10 (default), maximum is 50.  }}
{{api_args|base_app|false|int|是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。}}|
+
{{api_args|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)}}|
 
result=
 
result=
 
<pre>
 
<pre>

2018年5月22日 (二) 17:26的版本

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评价