Statuses/search
第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,参考[[省份城市编码表]]}} |
− | false | + | {{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>Tue Jan 26 14:11:31 +0800 2010</created_at> | |
− | + | <id>2471249</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_status_id> | |
− | + | <in_reply_to_user_id></in_reply_to_user_id> | |
− | + | <in_reply_to_screen_name></in_reply_to_screen_name> | |
− | + | <user> | |
− | + | <id>1535939882</id> | |
− | + | <screen_name>谢东中</screen_name> | |
− | + | <name>谢东中</name> | |
− | + | <province>44</province> | |
− | === | + | <city>1</city> |
− | + | <location>广东 广州</location> | |
− | + | <description>无字天书</description> | |
− | + | <profile_image_url>http://tp3.sinaimg.cn/1535939882/50/1257243041</profile_image_url> | |
− | + | <domain>dongzhong</domain> | |
− | + | <gender></gender> | |
− | + | <email></email> | |
− | + | <qq>20034115</qq> | |
− | + | <msn>xiedzh_keeper@hotmail.com</msn> | |
− | + | <followers_count>90</followers_count> | |
− | + | <friends_count>187</friends_count> | |
− | + | <statuses_count>84</statuses_count> | |
− | + | <favourites_count>0</favourites_count> | |
− | + | <created_at>Fri Oct 30 00:00:00 +0800 2009</created_at> | |
− | + | <following>false</following> | |
− | + | <verified>false</verified> | |
− | + | <geo_enabled>false</geo_enabled> | |
− | + | </user> | |
− | + | <retweeted_status> | |
− | + | <created_at>Tue Jan 26 10:02:46 +0800 2010</created_at> | |
− | + | <id>2376920</id> | |
− | + | <text>巧克力巧克力~美女穿巧克力喽。更多美女&巧克力http://sinaurl.cn/hKYcY</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_status_id> | |
− | + | <in_reply_to_user_id></in_reply_to_user_id> | |
− | + | <in_reply_to_screen_name></in_reply_to_screen_name> | |
− | + | <thumbnail_pic>http://ss16.sinaimg.cn/thumbnail/5e6d8fb0t7e07aeb4675f&690</thumbnail_pic> | |
− | + | <bmiddle_pic>http://ss16.sinaimg.cn/bmiddle/5e6d8fb0t7e07aeb4675f&690</bmiddle_pic> | |
− | + | <original_pic>http://ss16.sinaimg.cn/orignal/5e6d8fb0t7e07aeb4675f&690</original_pic> | |
− | + | <user> | |
− | + | <id>1584238512</id> | |
− | + | <screen_name>饭统网</screen_name> | |
− | + | <name>饭统网</name> | |
− | + | <province>11</province> | |
− | + | <city>8</city> | |
− | + | <location>北京 海淀区</location> | |
− | + | <description>餐饮时尚风向标 有你有味道!</description> | |
− | + | <profile_image_url>http://tp1.sinaimg.cn/1584238512/50/1253776480</profile_image_url> | |
− | + | <domain>ourfantong</domain> | |
− | + | <gender></gender> | |
− | + | <email></email> | |
− | + | <qq></qq> | |
− | + | <msn></msn> | |
− | + | <followers_count>1272</followers_count> | |
− | + | <friends_count>17</friends_count> | |
− | + | <statuses_count>196</statuses_count> | |
− | + | <favourites_count>0</favourites_count> | |
− | + | <created_at>Thu Sep 24 00:00:00 +0800 2009</created_at> | |
− | + | <following>false</following> | |
− | + | <verified>true</verified> | |
− | + | <geo_enabled>false</geo_enabled> | |
− | + | </user> | |
− | + | </retweeted_status> | |
− | + | </status> | |
− | + | <total_count_maybe>4</total_count_maybe> | |
− | + | </statuses> | |
− | + | </searchResult> | |
− | + | </pre> | |
− | + | ===JSON示例(无callback参数)=== | |
− | + | <pre> | |
− | + | 暂无 | |
− | + | </pre> | |
− | + | ===JSON示例(callback=foo)=== | |
− | + | <pre> | |
− | + | 暂无 | |
− | + | </pre>| | |
− | + | useAge=无| | |
− | + | otherInfo=无 | |
− | + | }} | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | === | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + |
2010年12月10日 (五) 18:39的版本
目录 |
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>Tue Jan 26 14:11:31 +0800 2010</created_at> <id>2471249</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_status_id> <in_reply_to_user_id></in_reply_to_user_id> <in_reply_to_screen_name></in_reply_to_screen_name> <user> <id>1535939882</id> <screen_name>谢东中</screen_name> <name>谢东中</name> <province>44</province> <city>1</city> <location>广东 广州</location> <description>无字天书</description> <profile_image_url>http://tp3.sinaimg.cn/1535939882/50/1257243041</profile_image_url> <domain>dongzhong</domain> <gender></gender> <email></email> <qq>20034115</qq> <msn>xiedzh_keeper@hotmail.com</msn> <followers_count>90</followers_count> <friends_count>187</friends_count> <statuses_count>84</statuses_count> <favourites_count>0</favourites_count> <created_at>Fri Oct 30 00:00:00 +0800 2009</created_at> <following>false</following> <verified>false</verified> <geo_enabled>false</geo_enabled> </user> <retweeted_status> <created_at>Tue Jan 26 10:02:46 +0800 2010</created_at> <id>2376920</id> <text>巧克力巧克力~美女穿巧克力喽。更多美女&巧克力http://sinaurl.cn/hKYcY</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_status_id> <in_reply_to_user_id></in_reply_to_user_id> <in_reply_to_screen_name></in_reply_to_screen_name> <thumbnail_pic>http://ss16.sinaimg.cn/thumbnail/5e6d8fb0t7e07aeb4675f&690</thumbnail_pic> <bmiddle_pic>http://ss16.sinaimg.cn/bmiddle/5e6d8fb0t7e07aeb4675f&690</bmiddle_pic> <original_pic>http://ss16.sinaimg.cn/orignal/5e6d8fb0t7e07aeb4675f&690</original_pic> <user> <id>1584238512</id> <screen_name>饭统网</screen_name> <name>饭统网</name> <province>11</province> <city>8</city> <location>北京 海淀区</location> <description>餐饮时尚风向标 有你有味道!</description> <profile_image_url>http://tp1.sinaimg.cn/1584238512/50/1253776480</profile_image_url> <domain>ourfantong</domain> <gender></gender> <email></email> <qq></qq> <msn></msn> <followers_count>1272</followers_count> <friends_count>17</friends_count> <statuses_count>196</statuses_count> <favourites_count>0</favourites_count> <created_at>Thu Sep 24 00:00:00 +0800 2009</created_at> <following>false</following> <verified>true</verified> <geo_enabled>false</geo_enabled> </user> </retweeted_status> </status> <total_count_maybe>4</total_count_maybe> </statuses> </searchResult>
JSON示例(无callback参数)
暂无
JSON示例(callback=foo)
暂无
其他
无