Weibo Platform Logo

微博开放平台

weibo

Trends/statuses

跳转到： 导航, 搜索
(→statuses/public_timeline)
 
（未显示3个用户的8个中间版本）
第1行： 第1行：
−
== trends/statuses ==
+
{{api_desc2|
−
返回最新更新的20条微博消息。为避免资源浪费及提高效率，对消息缓存60秒。
+
uri=trends/statuses|
−
 
+
desc=获取某话题下的微博消息。|
−
{{Api_url|statuses/public_timeline}}
+
format=XML/JSON|
−
+
httpMethod=GET|
−
{{Api_format|xml, json}}
+
needAuth=true|
−
 
+
rateLimit=true|
−
{{Api_req|GET|false|true}}
+
params={{api_args|trend_name|true|string|话题关键词。}}|
−
+
getParam=|
−
=== 返回结果 ===
+
postParam=-d "trend_name=java"|
−
XML示例:
+
result=
−
注意geo地理位置字段仅对有地理位置的微博才有返回
+
===XML示例===
 
<pre>
 
<pre>
 
  <?xml version="1.0" encoding="UTF-8"?>
 
  <?xml version="1.0" encoding="UTF-8"?>
 
  <statuses>
 
  <statuses>
−
<status>
+
  <status>
−
     <created_at>Tue Dec 01 08:51:58 +0800 2009</created_at>
+
     <created_at>Tue Nov 02 14:42:32 +0800 2010</created_at>
−
     <id>99999999</id>
+
     <id>3397147109</id>
−
     <text>只见AC米兰的巴蒂斯图塔突破马尔蒂尼，一脚凌空抽射，被裁判扑了出来。</text>
+
     <text>回复@星月的守护:都学啊，现在上JAVA，WINDOWS程序设计;以前学过C，C++。不过不通，现在成问题了。//@星月的守护:你学什么语言？</text>
 
     <source>
 
     <source>
−
       <a href="http://t.sina.com.cn">Web</a>
+
       <a href="http://news.sina.com.cn/wap/wbk.html">新浪微博手机版</a>
 
     </source>
 
     </source>
 
     <favorited>false</favorited>
 
     <favorited>false</favorited>
 
     <truncated>false</truncated>
 
     <truncated>false</truncated>
−
     <in_reply_to_status_id></in_reply_to_status_id>
+
     <geo/>
−
     <in_reply_to_user_id></in_reply_to_user_id>
+
     <in_reply_to_status_id/>
−
     <in_reply_to_screen_name></in_reply_to_screen_name>
+
     <in_reply_to_user_id/>
−
     <thumbnail_pic>http://static16.photo.sina.com.cn/thumbnail/62988d06tcbbc377f7bbf</thumbnail_pic>
+
     <in_reply_to_screen_name/>
−
    <bmiddle_pic>http://static16.photo.sina.com.cn/bmiddle/62988d06tcbbc377f7bbf</bmiddle_pic>
+
−
    <original_pic>http://static16.photo.sina.com.cn/orignal/62988d06tcbbc377f7bbf</original_pic>
+
−
    <geo xmlns:georss="http://www.georss.org/georss">
+
−
      <georss:point>23.12 -122.39697</georss:point>
+
−
    </geo>
+
 
     <user>
 
     <user>
−
       <id>1141457724</id>
+
       <id>1752561793</id>
−
       <screen_name>1141457724</screen_name>
+
       <screen_name>RuanP</screen_name>
−
       <name>1141457724</name>
+
       <name>RuanP</name>
−
       <location>广州</location>
+
      <province>42</province>
−
       <description>blog: timyang.net</description>
+
      <city>1000</city>
−
       <url>http://timyang.net</url>
+
       <location>湖北</location>
−
       <profile_image_url>http://portrait.sinaimg.cn/1141457724/50#.jpg</profile_image_url>
+
       <description>海内存知己，天涯若比邻！</description>
−
       <followers_count>0</followers_count>
+
       <url>http://blog.sina.com.cn/pianruan</url>
−
       <friends_count>0</friends_count>
+
       <profile_image_url>http://tp2.sinaimg.cn/1752561793/50/1288011459</profile_image_url>
−
       <statuses_count>0</statuses_count>
+
      <domain>ruanpian</domain>
 +
      <gender>f</gender>
 +
       <followers_count>10</followers_count>
 +
       <friends_count>9</friends_count>
 +
       <statuses_count>77</statuses_count>
 
       <favourites_count>0</favourites_count>
 
       <favourites_count>0</favourites_count>
 +
      <created_at>Tue Jun 08 00:00:00 +0800 2010</created_at>
 
       <following>false</following>
 
       <following>false</following>
−
       <verified>true</verified>
+
       <verified>false</verified>
 +
      <allow_all_act_msg>true</allow_all_act_msg>
 +
      <geo_enabled>true</geo_enabled>
 
     </user>
 
     </user>
−
     </status>
+
     <retweeted_status>
−
  ...
+
      <created_at>Tue Nov 02 11:17:59 +0800 2010</created_at>
−
   </statuses>
+
      <id>3393817355</id>
 +
      <text>计算机语言，令人头疼的问题#</text>
 +
      <source>
 +
        <a href="http://news.sina.com.cn/wap/wbk.html">新浪微博手机版</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>1752561793</id>
 +
        <screen_name>RuanP</screen_name>
 +
        <name>RuanP</name>
 +
        <province>42</province>
 +
        <city>1000</city>
 +
        <location>湖北</location>
 +
        <description>海内存知己，天涯若比邻！</description>
 +
        <url>http://blog.sina.com.cn/pianruan</url>
 +
        <profile_image_url>http://tp2.sinaimg.cn/1752561793/50/1288011459</profile_image_url>
 +
        <domain>ruanpian</domain>
 +
        <gender>f</gender>
 +
        <followers_count>10</followers_count>
 +
        <friends_count>9</friends_count>
 +
        <statuses_count>76</statuses_count>
 +
        <favourites_count>0</favourites_count>
 +
        <created_at>Tue Jun 08 00:00:00 +0800 2010</created_at>
 +
        <following>false</following>
 +
        <verified>false</verified>
 +
        <allow_all_act_msg>true</allow_all_act_msg>
 +
        <geo_enabled>true</geo_enabled>
 +
      </user>
 +
    </retweeted_status>
 +
   </status>
 +
  ...
 +
<statuses>
 
</pre>
 
</pre>
−
JSON示例：
+
===JSON示例===
 
<pre>
 
<pre>
−
  [ {"created_at":"Wed  Jan  06  11:26:01  +0800 2010",
+
  [
−
  "id":142243,
+
    {
−
  "text":"test  test",
+
        "created_at": "Tue Nov 02 14:42:32 +0800 2010",
−
  "source":"<a id=\"0\"  href=\"http://t.sina.com.cn/\" rel=\"nofollow\">Web</a>",
+
        "favorited": false,
−
  "favorited":false,
+
        "geo": null,
−
  "truncated":false,
+
        "id": 3397147109,
−
  "in_reply_to_status_id":"",
+
        "in_reply_to_screen_name": "",
−
  "in_reply_to_user_id":"",
+
        "in_reply_to_status_id": "",
−
  "in_reply_to_screen_name":"",
+
        "in_reply_to_user_id": "",
−
  "geo":{"type": "Point","coordinates": [23.12 -122.39697]},
+
        "retweeted_status": {
−
  "user":{"id":10506,
+
            "created_at": "Tue Nov 02 11:17:59 +0800 2010",  
−
  "screen_name":"name_10506",
+
            "favorited": false,
−
  "name":"name_10506",
+
            "geo": null,
−
  "province":0,
+
            "id": 3393817355,  
−
  "city":0,
+
            "in_reply_to_screen_name": "",  
−
  "location":"",
+
            "in_reply_to_status_id": "",
−
  "description":"",
+
            "in_reply_to_user_id": "",
−
  "url":"",
+
            "source": "<a href=\"http://news.sina.com.cn/wap/wbk.html\" rel=\"nofollow\">\u65b0\u6d6a\u5fae\u535a\u624b\u673a\u7248</a>",  
−
  "profile_image_url":"http://tp3.sinaimg.cn/10506/50/0",
+
            "text": "\u8ba1\u7b97\u673a\u8bed\u8a00\uff0c\u4ee4\u4eba\u5934\u75bc\u7684\u95ee\u9898#",  
−
  "domain":"10506",
+
            "truncated": false,  
−
  "followers_count":24,
+
            "user": {
−
  "friends_count":50,
+
                "allow_all_act_msg": true,  
−
  "statuses_count":0,
+
                "city": "1000",  
−
  "favourites_count":21,
+
                "created_at": "Tue Jun 08 00:00:00 +0800 2010",  
−
  "created_at":"Thu  Jan  01  08:00:00  +0800  1970",
+
                "description": "\u6d77\u5185\u5b58\u77e5\u5df1\uff0c\u5929\u6daf\u82e5\u6bd4\u90bb\uff01",
−
  "following":false,
+
                "domain": "ruanpian",  
−
  "geo_enabled":false,
+
                "favourites_count": 0,  
−
  "verified":false}
+
                "followers_count": 10,
−
  },
+
                "following": false,  
−
  {},...
+
                "friends_count": 9,  
−
  ]
+
                "gender": "f",  
−
</pre>
+
                "geo_enabled": true,  
−
{{Param_statues}}
+
                "id": 1752561793,  
−
{{Param_user}}
+
                "location": "\u6e56\u5317",  
−
=== 使用示例===
+
                "name": "RuanP",  
−
需修改appkey
+
                "profile_image_url": "http://tp2.sinaimg.cn/1752561793/50/1288011459",  
−
* xml:
+
                "province": "42",  
−
curl -u uid:password http://api.t.sina.com.cn/statuses/public_timeline.xml?source=appkey
+
                "screen_name": "RuanP",  
−
 
+
                "statuses_count": 76,  
−
* json:
+
                "url": "http://blog.sina.com.cn/pianruan",  
−
curl -u uid:password http://api.t.sina.com.cn/statuses/public_timeline.json?source=appkey
+
                "verified": false
−
 
+
            }
−
====Java示例====
+
        },...
−
请从 [[SDK | 微博SDK开发包下载]] 下载Java SDK<br>
+
  ]
−
代码示例如下:
+
</pre>|
−
 
+
useAge=无|
−
package weibo4j.examples;
+
otherInfo=无
−
+
}}
−
import java.util.List;
+
−
import weibo4j.Status;
+
−
import weibo4j.Weibo;
+
−
import weibo4j.WeiboException;
+
−
+
−
public class GetPublicTimeline {
+
−
+
−
/**
+
−
* 获取最新更新的公共微博消息
+
−
* @param args
+
−
*/
+
−
public static void main(String[] args) {
+
−
System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY);
+
−
    System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET);
+
−
    try {
+
−
//获取前20条最新更新的公共微博消息
+
−
List<Status> statuses = getWeibo(false,args).getPublicTimeline();
+
−
for (Status status : statuses) {
+
−
            System.out.println(status.getUser().getName() + ":" +
+
−
                              status.getText());
+
−
        }
+
−
} catch (WeiboException e) {
+
−
e.printStackTrace();
+
−
}
+
−
}
+
−
+
−
private static Weibo getWeibo(boolean isOauth,String[] args) {
+
−
Weibo weibo = new Weibo();
+
−
if(isOauth) {//oauth验证方式 args[0]:访问的token；args[1]:访问的密匙
+
−
weibo.setToken(args[0], args[1]);
+
−
}else {//用户登录方式
+
−
    weibo.setUserId(args[0]);//用户名/ID
+
−
    weibo.setPassword(args[1]);//密码
+
−
}
+
−
return weibo;
+
−
}
+
−
  }
+
−
====PHP示例====
+
−
请从 [[SDK | 微博SDK开发包下载]] 处下载PHP SDK（支持OAuth验证之版本）<br>
+
−
代码示例如下:
+
−
<pre>
+
−
//Statuses/public timeline
+
−
//获取前20条最新更新的公共微博消息
+
−
$c = new WeiboClient( WB_AKEY ,
+
−
                      WB_SKEY ,
+
−
                      $_SESSION['last_key']['oauth_token'] ,
+
−
                      $_SESSION['last_key']['oauth_token_secret']  );
+
−
 
+
−
$msg  = $c->public_timeline();
+
−
if ($msg === false || $msg === null){
+
−
echo "Error occured";
+
−
return false;
+
−
}
+
−
if (isset($msg['error_code']) && isset($msg['error'])){
+
−
echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
+
−
return false;
+
−
}
+
−
foreach ($msg as $data){
+
−
$user_name = $data['user']['name'];
+
−
$text = $data['text'];
+
−
echo $user_name."=".$text.";";
+
−
}
+
−
</pre>
+

2012年9月24日 (一) 11:42的最后版本

目录

trends/statuses

获取某话题下的微博消息。

URL

http://api.t.sina.com.cn/trends/statuses.(json%7Cxml)

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

true
关于授权机制，参见授权机制声明

请求数限制

true
关于请求数限制，参见接口访问权限说明

请求参数

  必选 类型及范围 说明
source true string 申请应用时分配的AppKey，调用接口时候代表应用的唯一身份。（采用OAuth授权方式不需要此参数）
trend_name true string 话题关键词。

注意事项

无

返回结果

XML示例

 <?xml version="1.0" encoding="UTF-8"?>
 <statuses>
  <status>
    <created_at>Tue Nov 02 14:42:32 +0800 2010</created_at>
    <id>3397147109</id>
    <text>回复@星月的守护:都学啊，现在上JAVA，WINDOWS程序设计;以前学过C，C++。不过不通，现在成问题了。//@星月的守护:你学什么语言？</text>
    <source>
      <a href="http://news.sina.com.cn/wap/wbk.html">新浪微博手机版</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>1752561793</id>
      <screen_name>RuanP</screen_name>
      <name>RuanP</name>
      <province>42</province>
      <city>1000</city>
      <location>湖北</location>
      <description>海内存知己，天涯若比邻！</description>
      <url>http://blog.sina.com.cn/pianruan</url>
      <profile_image_url>http://tp2.sinaimg.cn/1752561793/50/1288011459</profile_image_url>
      <domain>ruanpian</domain>
      <gender>f</gender>
      <followers_count>10</followers_count>
      <friends_count>9</friends_count>
      <statuses_count>77</statuses_count>
      <favourites_count>0</favourites_count>
      <created_at>Tue Jun 08 00:00:00 +0800 2010</created_at>
      <following>false</following>
      <verified>false</verified>
      <allow_all_act_msg>true</allow_all_act_msg>
      <geo_enabled>true</geo_enabled>
    </user>
    <retweeted_status>
      <created_at>Tue Nov 02 11:17:59 +0800 2010</created_at>
      <id>3393817355</id>
      <text>计算机语言，令人头疼的问题#</text>
      <source>
        <a href="http://news.sina.com.cn/wap/wbk.html">新浪微博手机版</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>1752561793</id>
        <screen_name>RuanP</screen_name>
        <name>RuanP</name>
        <province>42</province>
        <city>1000</city>
        <location>湖北</location>
        <description>海内存知己，天涯若比邻！</description>
        <url>http://blog.sina.com.cn/pianruan</url>
        <profile_image_url>http://tp2.sinaimg.cn/1752561793/50/1288011459</profile_image_url>
        <domain>ruanpian</domain>
        <gender>f</gender>
        <followers_count>10</followers_count>
        <friends_count>9</friends_count>
        <statuses_count>76</statuses_count>
        <favourites_count>0</favourites_count>
        <created_at>Tue Jun 08 00:00:00 +0800 2010</created_at>
        <following>false</following>
        <verified>false</verified>
        <allow_all_act_msg>true</allow_all_act_msg>
        <geo_enabled>true</geo_enabled>
      </user>
    </retweeted_status>
  </status>
   ...
 <statuses>

JSON示例

 [
    {
        "created_at": "Tue Nov 02 14:42:32 +0800 2010", 
        "favorited": false, 
        "geo": null, 
        "id": 3397147109, 
        "in_reply_to_screen_name": "", 
        "in_reply_to_status_id": "", 
        "in_reply_to_user_id": "", 
        "retweeted_status": {
            "created_at": "Tue Nov 02 11:17:59 +0800 2010", 
            "favorited": false, 
            "geo": null, 
            "id": 3393817355, 
            "in_reply_to_screen_name": "", 
            "in_reply_to_status_id": "", 
            "in_reply_to_user_id": "", 
            "source": "<a href=\"http://news.sina.com.cn/wap/wbk.html\" rel=\"nofollow\">\u65b0\u6d6a\u5fae\u535a\u624b\u673a\u7248</a>", 
            "text": "\u8ba1\u7b97\u673a\u8bed\u8a00\uff0c\u4ee4\u4eba\u5934\u75bc\u7684\u95ee\u9898#", 
            "truncated": false, 
            "user": {
                "allow_all_act_msg": true, 
                "city": "1000", 
                "created_at": "Tue Jun 08 00:00:00 +0800 2010", 
                "description": "\u6d77\u5185\u5b58\u77e5\u5df1\uff0c\u5929\u6daf\u82e5\u6bd4\u90bb\uff01", 
                "domain": "ruanpian", 
                "favourites_count": 0, 
                "followers_count": 10, 
                "following": false, 
                "friends_count": 9, 
                "gender": "f", 
                "geo_enabled": true, 
                "id": 1752561793, 
                "location": "\u6e56\u5317", 
                "name": "RuanP", 
                "profile_image_url": "http://tp2.sinaimg.cn/1752561793/50/1288011459", 
                "province": "42", 
                "screen_name": "RuanP", 
                "statuses_count": 76, 
                "url": "http://blog.sina.com.cn/pianruan", 
                "verified": false
            }
        },...
 ]

其他

无

来自“http://open.weibo.com/wiki/index.php?title=Trends/statuses&oldid=9465”
文档更新时间: 2012-09-24

关于微博开放平台| 联系我们| 服务条款| 无线游戏| 开放平台官微

京网文 [2011] 0398-130号 京ICP证100780号 Copyright © 1996-2024 SINA