C/2/search/statuses/limited/en

跳转到: 导航, 搜索
(以“{{Api_desc_business_en| uri=search/statuses/limited| desc=Search for weibos by the multiple conditions.| httpMethod=GET| needAuth=true| rateLimit={{B_rate_limit}}| p...”为内容创建页面)
 
 
(未显示1个用户的15个中间版本)
第4行: 第4行:
 
httpMethod=GET|
 
httpMethod=GET|
 
needAuth=true|
 
needAuth=true|
rateLimit={{B_rate_limit}}|
+
rateLimit={{B_rate_limit_en}}|
 
params=
 
params=
 
{{api_args|q|true|string|Keyword for searching.It must be encoded by URLencoding.}}
 
{{api_args|q|true|string|Keyword for searching.It must be encoded by URLencoding.}}
{{api_args|sort|false|string|排序方式,time:时间倒序、hot:热门度、fwnum:按转发数倒序、cmtnum:评论数倒序,默认为time。}}
+
{{api_args|ids|false|string|Search the statuses which are created by the uids specified.The uids should be separated by ~, and are limited by 50 uids per call.}}
 +
{{api_args|sort|false|string|Return the weibos by the sort type.time : reverse order by time; hot : order by hot; fwnum:  reverse order by repost count; cmtnum: reverse order by comment count; Default is time.}}
 
{{api_args|starttime|false|int|Begin time. Unix timestamp format.}}
 
{{api_args|starttime|false|int|Begin time. Unix timestamp format.}}
 
{{api_args|endtime|false|int|End time. Unix timestamp format.}}
 
{{api_args|endtime|false|int|End time. Unix timestamp format.}}
{{api_args|hasori|false|int|是否包含原创,0:否、1:是,默认为空(全部)。}}
+
{{api_args|hasori|false|int|Whether contains the original.0: original is not included; 1: only original is included;Default is null(all).}}
{{api_args|hasret|false|int|是否包含转发,0:否、1:是,默认为空(全部)。}}
+
{{api_args|hasret|false|int|Whether contains the repost.0: repost is not included; 1: only repost is included;Default is null(all).}}
{{api_args|hastext|false|int|是否为纯文本,0:否、1:是,默认为空(全部)。}}
+
{{api_args|hastext|false|int|Whether contains the pure text.0: pure text is not included; 1: only pure text is included;Default is null(all).}}
{{api_args|haspic|false|int|是否包含图片,0:否、1:是,默认为空(全部)。}}
+
{{api_args|haspic|false|int|Whether contains the picture.0: picture is not included; 1: only picture is included;Default is null(all).}}
{{api_args|hasvideo|false|int|是否包含视频,0:否、1:是,默认为空(全部)。}}
+
{{api_args|hasvideo|false|int|Whether contains the video.0: video is not included; 1: only video is included;Default is null(all).}}
{{api_args|hasmusic|false|int|是否包含音乐,0:否、1:是,默认为空(全部)。}}
+
{{api_args|hasmusic|false|int|Whether contains the music.0: music is not included; 1: only music is included;Default is null(all).}}
{{api_args|haslink|false|int|是否包含链接,0:否、1:是,默认为空(全部)。}}
+
{{api_args|haslink|false|int|Whether contains the short link.0: short link is not included; 1: only short link is included;Default is null(all).}}
{{api_args|hasat|false|int|是否包含@,0:否、1:是,默认为空(全部)。}}
+
{{api_args|hasat|false|int|Whether contains the '@'.0: '@' is not included; 1: only '@' is included;Default is null(all).}}
{{api_args|hasv|false|int|是否为v用户发言,0:否、1:是,默认为空(全部)。}}
+
{{api_args|hasv|false|int|Whether created by 'V' users.0:no; 1:yes; Default is null(all).}}
{{api_args|istag|false|int|是否为搜##内的话题,0:否、1:模糊匹配、2:精确匹配,默认为0。}}
+
{{api_args|istag|false|int| 0:keywords are not only included between '##'; 1:keywords are only included between '##' and match approximately; 2:keywords are only included between '##' and match exactly; Default is 0.}}
{{api_args|onlynum|false|int|是否只返回总数,0:否、1:是,默认为0。}}
+
{{api_args|onlynum|false|int|Whether only returns the total number. 0: no; 1: yes;Default is 0.}}
{{api_args|dup|false|int|是否排重(不显示相似数据),0:否、1:是,默认为1。}}
+
{{api_args|dup|false|int|Whether returns the similar weibos. 0: no; 1: yes; Default is 1.}}
{{api_args|antispam|false|int|是否反垃圾(不显示低质量数据),0:否、1:是,默认为1。}}
+
{{api_args|antispam|false|int|Whether only returns the high quality weibos. 0: no; 1:yes; Default is 1.}}
 
{{api_args|page|false|int|The returned page.Default is 1.}}
 
{{api_args|page|false|int|The returned page.Default is 1.}}
 
{{api_args|count|false|int|The returned count for every page.Default is 10.The max value is 50}}
 
{{api_args|count|false|int|The returned count for every page.Default is 10.The max value is 50}}
{{api_args|base_app|false|int|Whether get the data based on current application only. 1 is only current application; 0 is no limitation. The default value is 0.}}|
+
{{api_args|base_app|false|int|Whether returns the datas based on current application only. 1 is only current application; 0 is no limitation. Default is 0.}}|
 
result=
 
result=
 
<pre>
 
<pre>
第81行: 第82行:
 
</pre>|
 
</pre>|
 
resultDes={{Rdes_status_en}}|
 
resultDes={{Rdes_status_en}}|
useAge=*根据购买的返回条数,返回相应的搜索结果条数,最多返回1000条微博,与搜到的总数会不一致;
+
useAge=*The largest number of weibos returned is 1000 for every time period;
*购买的返回条数不能小于每页返回的数量;
+
*The value 'fwnum', 'cmtnum', 'hot' of parameter 'sort' is only valid for original weibos;|
*sort参数值fwnum, cmtnum, hot 都只对近期原创微博有效。若返回的是转发微博,则sort为这三种排序时无数据返回;|
+
otherInfo=<!--*The value format "XXX" of parameter 'q' means exact match;-->
otherInfo=*关键词q用英文双引号引起后,再UTF-8编码,搜索时表示精确匹配;
+
*<nowiki>The value of parameter 'q' supports '&', '|','-';</nowiki>
*关键词内容支持与、或、非。最好是5个词以内,并且最好一次使用一种语法;
+
**&: A B
**与:空格即可,如A B
+
**<nowiki>|: A~B~C</nowiki>
**或:~表示,如A~B~C
+
**-: A -B
**非:空格-,比如A -B,表示出现A,不出现B
+
*A,B and C can not be the specific symbols except  for letter and number;
**混用情况:(A B)~(C D)表示同时出现A,B或同时出现C,D, A B -C表示同时出现A,B但不出现C
+
  
 
}}{{#a:showgrade}}
 
}}{{#a:showgrade}}

2013年12月12日 (四) 16:15的最后版本

search/statuses/limited

Search for weibos by the multiple conditions.

URL

https://c.api.weibo.com/2/search/statuses/limited.json

Supported Formats

JSON

HTTP Request Method

GET

Requires Login

true
See the Login and Authorization Mechanism Statement for login and authorization details.

Requests Count Limitation


Request all APIs:

    • 50000/hour/IP;

Request Parameters

  Requires Type and Range Description
source false string This parameter is not needed when using OAuth.The value of this parameter is the AppKey.
access_token false string This parameter is required when using OAuth.You will get the access_token after oauth authorization.
q true string Keyword for searching.It must be encoded by URLencoding.
ids false string Search the statuses which are created by the uids specified.The uids should be separated by ~, and are limited by 50 uids per call.
sort false string Return the weibos by the sort type.time : reverse order by time; hot : order by hot; fwnum: reverse order by repost count; cmtnum: reverse order by comment count; Default is time.
starttime false int Begin time. Unix timestamp format.
endtime false int End time. Unix timestamp format.
hasori false int Whether contains the original.0: original is not included; 1: only original is included;Default is null(all).
hasret false int Whether contains the repost.0: repost is not included; 1: only repost is included;Default is null(all).
hastext false int Whether contains the pure text.0: pure text is not included; 1: only pure text is included;Default is null(all).
haspic false int Whether contains the picture.0: picture is not included; 1: only picture is included;Default is null(all).
hasvideo false int Whether contains the video.0: video is not included; 1: only video is included;Default is null(all).
hasmusic false int Whether contains the music.0: music is not included; 1: only music is included;Default is null(all).
haslink false int Whether contains the short link.0: short link is not included; 1: only short link is included;Default is null(all).
hasat false int Whether contains the '@'.0: '@' is not included; 1: only '@' is included;Default is null(all).
hasv false int Whether created by 'V' users.0:no; 1:yes; Default is null(all).
istag false int 0:keywords are not only included between '##'; 1:keywords are only included between '##' and match approximately; 2:keywords are only included between '##' and match exactly; Default is 0.
onlynum false int Whether only returns the total number. 0: no; 1: yes;Default is 0.
dup false int Whether returns the similar weibos. 0: no; 1: yes; Default is 1.
antispam false int Whether only returns the high quality weibos. 0: no; 1:yes; Default is 1.
page false int The returned page.Default is 1.
count false int The returned count for every page.Default is 10.The max value is 50
base_app false int Whether returns the datas based on current application only. 1 is only current application; 0 is no limitation. Default is 0.

Notes

  • The largest number of weibos returned is 1000 for every time period;
  • The value 'fwnum', 'cmtnum', 'hot' of parameter 'sort' is only valid for original weibos;

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
}

See the Error Code Description for the error information details.

Field Description

Returned Field Field Type Field Description
idstr string Weibo ID of string
created_at string Created time
id int64 Weibo ID
text string Weibo content
source string Weibo source
favorited boolean Whether it is favorited
truncated boolean Whether it is truncated
in_reply_to_status_id int64 The reply’s ID
in_reply_to_user_id int64 Replyer ID
in_reply_to_screen_name string Replyer nickname
mid int64 Weibo MID
bmiddle_pic string Medium picture
original_pic string Original picture
thumbnail_pic string Thumbnail picture
reposts_count int Repost count
comments_count int Comment count
annotations array Weibo annotation information
geo object Geography information
user object User profile that posted the weibo

Others

  • The value of parameter 'q' supports '&', '|','-';
    • &: A B
    • |: A~B~C
    • -: A -B
  • A,B and C can not be the specific symbols except for letter and number;



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


文档更新时间: 2013-12-12
api评价