statuses/search

返回关键字匹配的微博。

URL

http://api.t.sina.com.cn/statuses/search.format

格式

xml, json

HTTP请求方式

GET

是否需要登录

true

请求数限制

true

请求参数

• q： 选填参数. 查询的关键字。必须进行url encode

o 示例: http://api.t.sina.com.cn/statuses/search.json?q=api

• filter_ori： 选填参数.过滤器，是否原创 (0为全部，5为原创，4为转发，默认0)

o 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&filter_ori=0

• filter_pic： 选填参数. 过滤器，是否含图 (0为全部，1为含图，2为不含图)

o 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&filter_pic=1

• fuid： 选填参数. 微博作者UID

o 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&fuid=11075

• province： 省份ID

o 示例: http://api.t.sina.com.cn/statuses/search.json?province=11

• city： 城市ID

o 示例: http://api.t.sina.com.cn/statuses/search.json?province=11&city=1

• starttime： 开始时间(unix时间戳)

o 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&starttime=1256289598

• endtime： 截止时间 (unix时间戳)

o 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&endtime=1256289598

• page： 选填参数，页码(从1开始, 默认1)

o 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&sort=1&page=1

• count(别名：rpp)：选填参数，每页返回的微博数，默认返回10条，最大200

o 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&sort=1&page=1&count=10

• callback： 可选参数. 仅JSON方式支持，用于JSONP callback作用。

o 示例: http://api.t.sina.com.cn/statuses/search.json?q=api&callback=foo

• needcount： 可选参数. 是否返回搜索结果数开关量，可选true/false，值为true时，返回值中，增加搜索结果数量字段。

o 示例: http://api.t.sina.com.cn/statuses/search.xml?source=appkey&q=php&needcount=true

返回结果

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>巧克力巧克力~美女穿巧克力喽。更多美女&amp;巧克力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>

使用示例

• xml:

curl http://api.t.sina.com.cn/statuses/search.xml?q=api

• json:

curl http://api.t.sina.com.cn/statuses/search.json?q=api