Statuses/search
(→请求参数) |
|||
(未显示1个用户的2个中间版本) | |||
第1行: | 第1行: | ||
− | + | {{api_desc2| | |
− | + | uri=statuses/search| | |
− | + | desc=返回与指定的一个或多个条件相匹配的微博。| | |
− | + | format=XML/JSON| | |
− | + | httpMethod=GET| | |
− | + | needAuth=false| | |
− | = | + | rateLimit=true| |
− | + | params={{api_args|q|false|string|搜索的关键字。必须进行[http://en.wikipedia.org/wiki/URL_encoding|URL Encode]}} | |
− | + | {{api_args|filter_ori|false|int|过滤器,是否为原创,0为全部,5为原创,4为转发。默认为0。}} | |
− | = | + | {{api_args|filter_pic|false|int|过滤器。是否包含图片。0为全部,1为包含,2为不包含。}} |
− | GET | + | {{api_args|fuid|false|int64|微博作者的用户ID。}} |
− | + | {{api_args|province|false|int|省份ID,参考[[省份城市编码表]]}} | |
− | + | {{api_args|city|false|int|城市ID,参考[[省份城市编码表]]}} | |
− | + | {{api_args|starttime|false|number|开始时间,Unix时间戳}} | |
− | + | {{api_args|endtime|false|number|结束时间,Unix时间戳}} | |
− | = | + | {{api_args|page|false|int|页码}} |
− | true | + | {{api_args|count|false|int|每页返回的微博数。(默认返回10条,最大200条。)}} |
− | + | {{api_args|needcount|false|boolean|返回结果中是否包含返回记录数。true则返回搜索结果记录数。}} | |
− | = | + | {{api_args|base_app|false|int|是否按照当前应用信息对搜索结果进行过滤。当值为1时,仅返回通过该应用发送的微博消息。}} |
− | + | {{api_args|callback|false|string|仅JSON方式支持,用于JSONP跨域数据访问。}}| | |
− | + | getParam=&q=王若琳&callback=foo| | |
− | + | postParam=| | |
− | + | result= | |
− | + | ===XML示例=== | |
− | + | <pre> | |
− | + | <?xml version="1.0" encoding="UTF-8"?> | |
− | + | <searchResult> | |
− | + | <statuses> | |
− | + | <status> | |
− | + | <created_at>Mon Dec 13 10:07:46 +0800 2010</created_at> | |
− | + | <id>4281864911</id> | |
− | + | <text>鼓楼一家店播放着小野丽莎的歌,我误认为是王若琳,重温下若琳的“有你的快乐”。</text> | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | === | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | <created_at> | + | |
− | <id> | + | |
− | <text> | + | |
<source> | <source> | ||
<a href="http://t.sina.com.cn">新浪微博</a> | <a href="http://t.sina.com.cn">新浪微博</a> | ||
第96行: | 第37行: | ||
<truncated>false</truncated> | <truncated>false</truncated> | ||
<geo/> | <geo/> | ||
− | <in_reply_to_status_id | + | <in_reply_to_status_id/> |
− | <in_reply_to_user_id | + | <in_reply_to_user_id/> |
− | <in_reply_to_screen_name | + | <in_reply_to_screen_name/> |
− | + | ||
− | + | ||
− | + | ||
<user> | <user> | ||
− | <id> | + | <id>1547460074</id> |
− | <screen_name> | + | <screen_name>谢炳碧浙温</screen_name> |
− | <name> | + | <name>谢炳碧浙温</name> |
− | <province> | + | <province>33</province> |
− | <city> | + | <city>3</city> |
− | <location> | + | <location>浙江 温州</location> |
− | <description> | + | <description>团结一切可以团结的力量。</description> |
− | <profile_image_url>http:// | + | <url>http://1</url> |
− | <domain | + | <profile_image_url>http://tp3.sinaimg.cn/1547460074/50/1289882541/1</profile_image_url> |
− | <gender></gender | + | <domain/> |
− | + | <gender>m</gender> | |
− | + | <followers_count>27</followers_count> | |
− | + | <friends_count>60</friends_count> | |
− | <followers_count> | + | <statuses_count>37</statuses_count> |
− | <friends_count> | + | |
− | <statuses_count> | + | |
<favourites_count>0</favourites_count> | <favourites_count>0</favourites_count> | ||
− | <created_at> | + | <created_at>Tue Nov 16 00:00:00 +0800 2010</created_at> |
<following>false</following> | <following>false</following> | ||
− | <verified> | + | <verified>false</verified> |
− | < | + | <allow_all_act_msg>false</allow_all_act_msg> |
+ | <geo_enabled>true</geo_enabled> | ||
</user> | </user> | ||
− | + | <annotations/> | |
− | + | </status> | |
− | + | ... | |
− | + | </statuses> | |
− | + | </searchResult> | |
− | + | </pre> | |
− | === | + | ===JSON示例(无callback参数)=== |
+ | <pre> | ||
+ | [ | ||
+ | { | ||
+ | "created_at" : "Mon Dec 13 10:07:46 +0800 2010", | ||
+ | "text" : "鼓楼一家店播放着小野丽莎的歌,我误认为是王若琳,重温下若琳的“有你的快乐”。", | ||
+ | "truncated" : false, | ||
+ | "in_reply_to_status_id" : "", | ||
+ | "annotations" : | ||
+ | [ | ||
− | + | ], | |
− | + | "in_reply_to_screen_name" : "", | |
+ | "geo" : null, | ||
+ | "user" : | ||
+ | { | ||
+ | "name" : "谢炳碧浙温", | ||
+ | "domain" : "", | ||
+ | "geo_enabled" : true, | ||
+ | "followers_count" : 27, | ||
+ | "statuses_count" : 37, | ||
+ | "favourites_count" : 0, | ||
+ | "city" : "3", | ||
+ | "description" : "团结一切可以团结的力量。", | ||
+ | "verified" : false, | ||
+ | "id" : 1547460074, | ||
+ | "gender" : "m", | ||
+ | "friends_count" : 60, | ||
+ | "screen_name" : "谢炳碧浙温", | ||
+ | "allow_all_act_msg" : false, | ||
+ | "following" : false, | ||
+ | "url" : "http://1", | ||
+ | "profile_image_url" : "http://tp3.sinaimg.cn/1547460074/50/1289882541/1", | ||
+ | "created_at" : "Tue Nov 16 00:00:00 +0800 2010", | ||
+ | "province" : "33", | ||
+ | "location" : "浙江 温州" | ||
+ | }, | ||
+ | "favorited" : false, | ||
+ | "in_reply_to_user_id" : "", | ||
+ | "id" : 4281864911, | ||
+ | "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>" | ||
+ | }, | ||
+ | ... | ||
+ | ] | ||
+ | </pre> | ||
+ | ===JSON示例(callback=foo)=== | ||
+ | <pre> | ||
+ | foo( | ||
+ | [ | ||
+ | { | ||
+ | "created_at" : "Mon Dec 13 10:07:46 +0800 2010", | ||
+ | "text" : "鼓楼一家店播放着小野丽莎的歌,我误认为是王若琳,重温下若琳的“有你的快乐”。", | ||
+ | "truncated" : false, | ||
+ | "in_reply_to_status_id" : "", | ||
+ | "annotations" : | ||
+ | [ | ||
− | + | ], | |
− | + | "in_reply_to_screen_name" : "", | |
+ | "geo" : null, | ||
+ | "user" : | ||
+ | { | ||
+ | "name" : "谢炳碧浙温", | ||
+ | "domain" : "", | ||
+ | "geo_enabled" : true, | ||
+ | "followers_count" : 27, | ||
+ | "statuses_count" : 37, | ||
+ | "favourites_count" : 0, | ||
+ | "city" : "3", | ||
+ | "description" : "团结一切可以团结的力量。", | ||
+ | "verified" : false, | ||
+ | "id" : 1547460074, | ||
+ | "gender" : "m", | ||
+ | "friends_count" : 60, | ||
+ | "screen_name" : "谢炳碧浙温", | ||
+ | "allow_all_act_msg" : false, | ||
+ | "following" : false, | ||
+ | "url" : "http://1", | ||
+ | "profile_image_url" : "http://tp3.sinaimg.cn/1547460074/50/1289882541/1", | ||
+ | "created_at" : "Tue Nov 16 00:00:00 +0800 2010", | ||
+ | "province" : "33", | ||
+ | "location" : "浙江 温州" | ||
+ | }, | ||
+ | "favorited" : false, | ||
+ | "in_reply_to_user_id" : "", | ||
+ | "id" : 4281864911, | ||
+ | "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>" | ||
+ | }, | ||
+ | ... | ||
+ | ] | ||
+ | ) | ||
+ | </pre>| | ||
+ | useAge=无| | ||
+ | otherInfo=无 | ||
+ | }}{{#a:showgrade}} |
2010年12月13日 (一) 10:13的最后版本
目录 |
statuses/search
返回与指定的一个或多个条件相匹配的微博。
URL
http://api.t.sina.com.cn/statuses/search.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
false
关于授权机制,参见授权机制声明
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数) |
q | false | string | 搜索的关键字。必须进行[http://en.wikipedia.org/wiki/URL_encoding |
filter_ori | false | int | 过滤器,是否为原创,0为全部,5为原创,4为转发。默认为0。 |
filter_pic | false | int | 过滤器。是否包含图片。0为全部,1为包含,2为不包含。 |
fuid | false | int64 | 微博作者的用户ID。 |
province | false | int | 省份ID,参考省份城市编码表 |
city | false | int | 城市ID,参考省份城市编码表 |
starttime | false | number | 开始时间,Unix时间戳 |
endtime | false | number | 结束时间,Unix时间戳 |
page | false | int | 页码 |
count | false | int | 每页返回的微博数。(默认返回10条,最大200条。) |
needcount | false | boolean | 返回结果中是否包含返回记录数。true则返回搜索结果记录数。 |
base_app | false | int | 是否按照当前应用信息对搜索结果进行过滤。当值为1时,仅返回通过该应用发送的微博消息。 |
callback | false | string | 仅JSON方式支持,用于JSONP跨域数据访问。 |
注意事项
无
返回结果
XML示例
<?xml version="1.0" encoding="UTF-8"?> <searchResult> <statuses> <status> <created_at>Mon Dec 13 10:07:46 +0800 2010</created_at> <id>4281864911</id> <text>鼓楼一家店播放着小野丽莎的歌,我误认为是王若琳,重温下若琳的“有你的快乐”。</text> <source> <a href="http://t.sina.com.cn">新浪微博</a> </source> <favorited>false</favorited> <truncated>false</truncated> <geo/> <in_reply_to_status_id/> <in_reply_to_user_id/> <in_reply_to_screen_name/> <user> <id>1547460074</id> <screen_name>谢炳碧浙温</screen_name> <name>谢炳碧浙温</name> <province>33</province> <city>3</city> <location>浙江 温州</location> <description>团结一切可以团结的力量。</description> <url>http://1</url> <profile_image_url>http://tp3.sinaimg.cn/1547460074/50/1289882541/1</profile_image_url> <domain/> <gender>m</gender> <followers_count>27</followers_count> <friends_count>60</friends_count> <statuses_count>37</statuses_count> <favourites_count>0</favourites_count> <created_at>Tue Nov 16 00:00:00 +0800 2010</created_at> <following>false</following> <verified>false</verified> <allow_all_act_msg>false</allow_all_act_msg> <geo_enabled>true</geo_enabled> </user> <annotations/> </status> ... </statuses> </searchResult>
JSON示例(无callback参数)
[ { "created_at" : "Mon Dec 13 10:07:46 +0800 2010", "text" : "鼓楼一家店播放着小野丽莎的歌,我误认为是王若琳,重温下若琳的“有你的快乐”。", "truncated" : false, "in_reply_to_status_id" : "", "annotations" : [ ], "in_reply_to_screen_name" : "", "geo" : null, "user" : { "name" : "谢炳碧浙温", "domain" : "", "geo_enabled" : true, "followers_count" : 27, "statuses_count" : 37, "favourites_count" : 0, "city" : "3", "description" : "团结一切可以团结的力量。", "verified" : false, "id" : 1547460074, "gender" : "m", "friends_count" : 60, "screen_name" : "谢炳碧浙温", "allow_all_act_msg" : false, "following" : false, "url" : "http://1", "profile_image_url" : "http://tp3.sinaimg.cn/1547460074/50/1289882541/1", "created_at" : "Tue Nov 16 00:00:00 +0800 2010", "province" : "33", "location" : "浙江 温州" }, "favorited" : false, "in_reply_to_user_id" : "", "id" : 4281864911, "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>" }, ... ]
JSON示例(callback=foo)
foo( [ { "created_at" : "Mon Dec 13 10:07:46 +0800 2010", "text" : "鼓楼一家店播放着小野丽莎的歌,我误认为是王若琳,重温下若琳的“有你的快乐”。", "truncated" : false, "in_reply_to_status_id" : "", "annotations" : [ ], "in_reply_to_screen_name" : "", "geo" : null, "user" : { "name" : "谢炳碧浙温", "domain" : "", "geo_enabled" : true, "followers_count" : 27, "statuses_count" : 37, "favourites_count" : 0, "city" : "3", "description" : "团结一切可以团结的力量。", "verified" : false, "id" : 1547460074, "gender" : "m", "friends_count" : 60, "screen_name" : "谢炳碧浙温", "allow_all_act_msg" : false, "following" : false, "url" : "http://1", "profile_image_url" : "http://tp3.sinaimg.cn/1547460074/50/1289882541/1", "created_at" : "Tue Nov 16 00:00:00 +0800 2010", "province" : "33", "location" : "浙江 温州" }, "favorited" : false, "in_reply_to_user_id" : "", "id" : 4281864911, "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>" }, ... ] )
其他
无
文档更新时间: 2010-12-13