Users/suggestions

跳转到: 导航, 搜索
(返回结果)
 
(未显示1个用户的1个中间版本)
第1行: 第1行:
== users/suggestions ==
+
{{api_desc2|
返回当前用户可能感兴趣的用户。
+
uri=users/suggestions|
 
+
desc=返回当前用户可能感兴趣的用户。|
=== URL===
+
format=XML/JSON|
http://api.t.sina.com.cn/users/suggestions.format
+
httpMethod=GET|
+
needAuth=true|
=== 格式===
+
rateLimit=true|
xml, json
+
params={{api_args|with_reason|false|int|是否返回推荐原因,可选值1/0。当值为1,返回结果中增加推荐原因,会大幅改变返回值格式。}}|
 
+
getParam=&with_reason=1|
=== HTTP请求方式===
+
postParam=|
GET
+
result=
+
===XML示例(with_reason=0)===
=== 是否需要身份验证===
+
true
+
 
+
=== 请求数限制===
+
true
+
 
+
=== 请求参数===
+
* cursor: 选填参数. 单页只能包含100个用户列表,为了获取更多则cursor默认从-1开始,通过增加或减少cursor来获取更多, 如果没有下一页,则next_cursor返回0的关注列表
+
* 示例: http://api.t.sina.com.cn/users/suggestions.xml?cursor=-1
+
* 示例: http://api.t.sina.com.cn/users/suggestions.xml?cursor=1300794057949944903
+
* count: 可选参数.  每次返回的最大记录数(即页面大小),不大于200,默认返回20。
+
* 示例: http://api.t.sina.com.cn/users/suggestions.xml?cursor=-1&count=200
+
* with_reason: 可选参数.  是否返回推荐原因,可选值True/False或者1/0。当值为1/True时,返回结果中增加推荐原因,会大幅改变返回值格式。
+
* 示例: http://api.t.sina.com.cn/users/suggestions.xml?cursor=-1&count=200
+
 
+
=== 使用说明===
+
* 如果没有提供cursor参数,将只返回最前面的100个关注列表
+
 
+
 
+
=== 返回结果===
+
XML示例:
+
 
<pre>
 
<pre>
<?xml version="1.0" encoding="UTF-8"?>
+
<?xml version="1.0" encoding="UTF-8"?>
<users_list>
+
<users>
<users>
+
 
   <user>
 
   <user>
  <id>11075</id>
+
    <id>1477356933</id>
  <screen_name>11075</screen_name>
+
    <screen_name>liudaoru</screen_name>
  <name>11075</name>
+
    <name>liudaoru</name>
  <province>广东</province>
+
    <province>11</province>
  <city>广州</city>
+
    <city>8</city>
  <location>广东 广州</location>
+
    <location>北京 海淀区</location>
  <description>blog: timyang.net</description>
+
    <description>80后,IT民工,总是富有各种想法,素以能折腾而闻名。。。</description>
  <url>http://timyang.net</url>
+
    <url>http://blog.sina.com.cn/liudaoru</url>
  <profile_image_url>http://portrait.sinaimg.cn/11075/50#.jpg</profile_image_url>
+
    <profile_image_url>http://tp2.sinaimg.cn/1477356933/50/1279879139/1</profile_image_url>
  <domain></domain>
+
    <domain>liudaoru</domain>
  <gender></gender>
+
    <gender>m</gender>
  <followers_count>0</followers_count>
+
    <followers_count>787</followers_count>
  <friends_count>0</friends_count>
+
    <friends_count>1158</friends_count>
  <statuses_count>0</statuses_count>
+
    <statuses_count>1401</statuses_count>
  <favourites_count>0</favourites_count>
+
    <favourites_count>509</favourites_count>
  <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at>
+
    <created_at>Thu Jan 21 00:00:00 +0800 2010</created_at>
  <following>false</following>
+
    <following>false</following>
  <verified>false</verified>
+
    <verified>false</verified>
  <geo_enabled>false</geo_enabled>
+
    <allow_all_act_msg>false</allow_all_act_msg>
  <status>
+
    <geo_enabled>true</geo_enabled>
    <created_at>Fri Dec 25 17:57:27 +0800 2009</created_at>
+
    <status>
    <id>19093</id>
+
      <created_at>Mon Dec 13 17:05:41 +0800 2010</created_at>
    <text>测试中国</text>
+
      <id>4420481591</id>
    <source>
+
      <text>转发微博</text>
      <a id="0" href="http://t.sina.com.cn">Web</a>
+
      <source>
    </source>
+
        <a href="http://wing.uedsite.com/">Wing微博2010</a>
    <favorited>false</favorited>
+
      </source>
    <truncated>false</truncated>
+
      <favorited>false</favorited>
    <geo/>
+
      <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/>
  </status>
+
      <in_reply_to_screen_name/>
 +
      <retweeted_status>
 +
        <created_at>Mon Dec 13 16:51:54 +0800 2010</created_at>
 +
        <id>4420179987</id>
 +
        <text>刚才浙江电信的工程师来给我安装调试ADSL,前后浪费我了两个多小时不说,看到业务流程处理之乱、服务态度之烂实在是叹为观止,无以复加。@浙江电信客服</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>1577826897</id>
 +
          <screen_name>Fenng</screen_name>
 +
          <name>Fenng</name>
 +
          <province>33</province>
 +
          <city>1</city>
 +
          <location>浙江 杭州</location>
 +
          <description>冯大辉,工作在丁香园( http://dxy.com , 医药生命科学专业网站),CTO。多年来一直做技术,说起来,也是个手艺人。Twitter 是我的主战场。</description>
 +
          <url>http://dbanotes.net</url>
 +
          <profile_image_url>http://tp2.sinaimg.cn/1577826897/50/1283204066/1</profile_image_url>
 +
          <domain>fenng</domain>
 +
          <gender>m</gender>
 +
          <followers_count>50394</followers_count>
 +
          <friends_count>1994</friends_count>
 +
          <statuses_count>2302</statuses_count>
 +
          <favourites_count>758</favourites_count>
 +
          <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
 +
          <following>false</following>
 +
          <verified>true</verified>
 +
          <allow_all_act_msg>false</allow_all_act_msg>
 +
          <geo_enabled>true</geo_enabled>
 +
        </user>
 +
        <annotations/>
 +
      </retweeted_status>
 +
    </status>
 
   </user>
 
   </user>
...................不分页没有此数据.................
+
   ...
   <next_cursor>1299072354878293926</next_cursor>
+
</users>
  <previous_cursor>0</previous_cursor>
+
..................................................
+
</users_list>
+
 
</pre>
 
</pre>
JSON示例:
+
===JSON示例(with_reason=0)===
 
<pre>
 
<pre>
  {"users":
+
[
  [{"id":9448,
+
    {
    "screen_name":"name_9448",
+
        "name" : "liudaoru",
    "name":"name_9448",
+
        "domain" : "liudaoru",
    "province":"0",
+
        "geo_enabled" : true,
    "city":"0",
+
        "followers_count" : 787,
    "location":"",
+
        "statuses_count" : 1401,
    "description":"",
+
        "favourites_count" : 509,
    "url":"",
+
        "city" : "8",
    "profile_image_url":"http://tp1.sinaimg.cn/9448/50/0",
+
        "description" : "80后,IT民工,总是富有各种想法,素以能折腾而闻名。。。",
    "domain":"9448",
+
        "verified" : false,
    "followers_count":30,
+
        "status" :
    "friends_count":0,
+
        {
    "statuses_count":0,
+
            "created_at" : "Mon Dec 13 17:05:41 +0800 2010",
    "favourites_count":0,
+
            "text" : "转发微博",
    "created_at":"Thu Jan 01 08:00:00 +0800 1970",
+
            "truncated" : false,
    "following":false,
+
            "retweeted_status" :
    "geo_enabled":false,
+
            {
    "verified":false},
+
                "created_at" : "Mon Dec 13 16:51:54 +0800 2010",
     {},
+
                "text" : "刚才浙江电信的工程师来给我安装调试ADSL,前后浪费我了两个多小时不说,看到业务流程处理之乱、服务态度之烂实在是叹为观止,无以复加。@浙江电信客服",
 +
                "truncated" : false,
 +
                "in_reply_to_status_id" : "",
 +
                "annotations" :
 +
                [
 +
 
 +
                ],
 +
                "in_reply_to_screen_name" : "",
 +
                "geo" : null,
 +
                "user" :
 +
                {
 +
                    "name" : "Fenng",
 +
                    "domain" : "fenng",
 +
                    "geo_enabled" : true,
 +
                    "followers_count" : 50394,
 +
                    "statuses_count" : 2302,
 +
                    "favourites_count" : 758,
 +
                    "city" : "1",
 +
                    "description" : "冯大辉,工作在丁香园( http://dxy.com , 医药生命科学专业网站),CTO。多年来一直做技术,说起来,也是个手艺人。Twitter 是我的主战场。",
 +
                    "verified" : true,
 +
                    "id" : 1577826897,
 +
                    "gender" : "m",
 +
                    "friends_count" : 1994,
 +
                    "screen_name" : "Fenng",
 +
                    "allow_all_act_msg" : false,
 +
                    "following" : false,
 +
                    "url" : "http://dbanotes.net",
 +
                    "profile_image_url" : "http://tp2.sinaimg.cn/1577826897/50/1283204066/1",
 +
                    "created_at" : "Fri Aug 28 00:00:00 +0800 2009",
 +
                    "province" : "33",
 +
                    "location" : "浙江 杭州"
 +
                },
 +
                "favorited" : false,
 +
                "in_reply_to_user_id" : "",
 +
                "id" : 4420179987,
 +
                "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
 +
            },
 +
            "in_reply_to_status_id" : "",
 +
            "in_reply_to_screen_name" : "",
 +
            "geo" : null,
 +
            "favorited" : false,
 +
            "in_reply_to_user_id" : "",
 +
            "id" : 4420481591,
 +
            "source" : "<a href=\"http://wing.uedsite.com/\" rel=\"nofollow\">Wing微博2010</a>"
 +
        },
 +
        "id" : 1477356933,
 +
        "gender" : "m",
 +
        "friends_count" : 1158,
 +
        "screen_name" : "liudaoru",
 +
        "allow_all_act_msg" : false,
 +
        "following" : false,
 +
        "url" : "http://blog.sina.com.cn/liudaoru",
 +
        "profile_image_url" : "http://tp2.sinaimg.cn/1477356933/50/1279879139/1",
 +
        "created_at" : "Thu Jan 21 00:00:00 +0800 2010",
 +
        "province" : "11",
 +
        "location" : "北京 海淀区"
 +
     },
 
     ...
 
     ...
  ]
+
]
...................不分页没有此数据.................
+
  ,
+
  "next_cursor":2,
+
  "previous_cursor":0}
+
..................................................
+
  }
+
 
</pre>
 
</pre>
=== 返回结果(包含推荐原因)===
+
===XML示例(with_reason=1)===
XML示例:
+
 
<pre>
 
<pre>
 
<?xml version="1.0" encoding="UTF-8"?>
 
<?xml version="1.0" encoding="UTF-8"?>
第116行: 第178行:
 
     <reason>area</reason>
 
     <reason>area</reason>
 
     <user>
 
     <user>
       <id>1642466141</id>
+
       <id>1477356933</id>
       <screen_name>huchao</screen_name>
+
       <screen_name>liudaoru</screen_name>
       <name>huchao</name>
+
       <name>liudaoru</name>
 
       <province>11</province>
 
       <province>11</province>
 
       <city>8</city>
 
       <city>8</city>
 
       <location>北京 海淀区</location>
 
       <location>北京 海淀区</location>
       <description/>
+
       <description>80后,IT民工,总是富有各种想法,素以能折腾而闻名。。。</description>
       <url>http://tuoniao.org</url>
+
       <url>http://blog.sina.com.cn/liudaoru</url>
       <profile_image_url>http://tp2.sinaimg.cn/1642466141/50/1285424071/1</profile_image_url>
+
       <profile_image_url>http://tp2.sinaimg.cn/1477356933/50/1279879139/1</profile_image_url>
       <domain>westy</domain>
+
       <domain>liudaoru</domain>
 
       <gender>m</gender>
 
       <gender>m</gender>
       <followers_count>121</followers_count>
+
       <followers_count>787</followers_count>
       <friends_count>74</friends_count>
+
       <friends_count>1158</friends_count>
       <statuses_count>335</statuses_count>
+
       <statuses_count>1401</statuses_count>
       <favourites_count>3</favourites_count>
+
       <favourites_count>509</favourites_count>
       <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
+
       <created_at>Thu Jan 21 00:00:00 +0800 2010</created_at>
 
       <following>false</following>
 
       <following>false</following>
 
       <verified>false</verified>
 
       <verified>false</verified>
第137行: 第199行:
 
       <geo_enabled>true</geo_enabled>
 
       <geo_enabled>true</geo_enabled>
 
       <status>
 
       <status>
         <created_at>Tue Nov 23 21:38:02 +0800 2010</created_at>
+
         <created_at>Mon Dec 13 17:05:41 +0800 2010</created_at>
         <id>3837257229</id>
+
         <id>4420481591</id>
         <text>忽然很想回家...</text>
+
         <text>转发微博</text>
 
         <source>
 
         <source>
           <a href="http://t.sina.com.cn">新浪微博</a>
+
           <a href="http://wing.uedsite.com/">Wing微博2010</a>
 
         </source>
 
         </source>
 
         <favorited>false</favorited>
 
         <favorited>false</favorited>
第149行: 第211行:
 
         <in_reply_to_user_id/>
 
         <in_reply_to_user_id/>
 
         <in_reply_to_screen_name/>
 
         <in_reply_to_screen_name/>
 +
        <retweeted_status>
 +
          <created_at>Mon Dec 13 16:51:54 +0800 2010</created_at>
 +
          <id>4420179987</id>
 +
          <text>刚才浙江电信的工程师来给我安装调试ADSL,前后浪费我了两个多小时不说,看到业务流程处理之乱、服务态度之烂实在是叹为观止,无以复加。@浙江电信客服</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>1577826897</id>
 +
            <screen_name>Fenng</screen_name>
 +
            <name>Fenng</name>
 +
            <province>33</province>
 +
            <city>1</city>
 +
            <location>浙江 杭州</location>
 +
            <description>冯大辉,工作在丁香园( http://dxy.com , 医药生命科学专业网站),CTO。多年来一直做技术,说起来,也是个手艺人。Twitter 是我的主战场。</description>
 +
            <url>http://dbanotes.net</url>
 +
            <profile_image_url>http://tp2.sinaimg.cn/1577826897/50/1283204066/1</profile_image_url>
 +
            <domain>fenng</domain>
 +
            <gender>m</gender>
 +
            <followers_count>50394</followers_count>
 +
            <friends_count>1994</friends_count>
 +
            <statuses_count>2302</statuses_count>
 +
            <favourites_count>758</favourites_count>
 +
            <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
 +
            <following>false</following>
 +
            <verified>true</verified>
 +
            <allow_all_act_msg>false</allow_all_act_msg>
 +
            <geo_enabled>true</geo_enabled>
 +
          </user>
 +
          <annotations/>
 +
        </retweeted_status>
 
       </status>
 
       </status>
 
     </user>
 
     </user>
 
   </suggested_user>
 
   </suggested_user>
 +
  ...
 
</suggested_users>
 
</suggested_users>
 
</pre>
 
</pre>
JSON示例:
+
===JSON示例(with_reason=1)===
 
<pre>
 
<pre>
 
[
 
[
 
     {
 
     {
         "reason": "area",  
+
         "reason" : "area",
         "user": {
+
         "user" :  
             "allow_all_act_msg": false,  
+
        {
             "city": "8",  
+
             "name" : "liudaoru",
             "created_at": "Fri Aug 28 00:00:00 +0800 2009",  
+
            "domain" : "liudaoru",
            "description": "",  
+
            "geo_enabled" : true,
            "domain": "westy",  
+
            "followers_count" : 787,
            "favourites_count": 3,  
+
            "statuses_count" : 1401,
            "followers_count": 121,  
+
            "favourites_count" : 509,
            "following": false,  
+
             "city" : "8",
            "friends_count": 74,  
+
             "description" : "80后,IT民工,总是富有各种想法,素以能折腾而闻名。。。",
            "gender": "m",  
+
            "verified" : false,
            "geo_enabled": true,  
+
            "status" :
            "id": 1642466141,  
+
            {
            "location": "\u5317\u4eac \u6d77\u6dc0\u533a",  
+
                "created_at" : "Mon Dec 13 17:05:41 +0800 2010",
            "name": "huchao",  
+
                "text" : "转发微博",
            "profile_image_url": "http://tp2.sinaimg.cn/1642466141/50/1285424071/1",  
+
                "truncated" : false,
            "province": "11",  
+
                "retweeted_status" :
            "screen_name": "huchao",  
+
                {
            "status": {
+
                    "created_at" : "Mon Dec 13 16:51:54 +0800 2010",
                "created_at": "Tue Nov 23 21:38:02 +0800 2010",  
+
                    "text" : "刚才浙江电信的工程师来给我安装调试ADSL,前后浪费我了两个多小时不说,看到业务流程处理之乱、服务态度之烂实在是叹为观止,无以复加。@浙江电信客服",
                "favorited": false,  
+
                    "truncated" : false,
                "geo": null,  
+
                    "in_reply_to_status_id" : "",
                 "id": 3837257229,  
+
                    "annotations" :
                 "in_reply_to_screen_name": "",  
+
                    [
                 "in_reply_to_status_id": "",  
+
 
                 "in_reply_to_user_id": "",  
+
                    ],
                 "source": "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">\u65b0\u6d6a\u5fae\u535a</a>",  
+
                    "in_reply_to_screen_name" : "",
                "text": "\u5ffd\u7136\u5f88\u60f3\u56de\u5bb6...",  
+
                    "geo" : null,
                "truncated": false
+
                    "user" :
             },  
+
                    {
             "statuses_count": 335,  
+
                        "name" : "Fenng",
             "url": "http://tuoniao.org",  
+
                        "domain" : "fenng",
             "verified": false
+
                        "geo_enabled" : true,
 +
                        "followers_count" : 50394,
 +
                        "statuses_count" : 2302,
 +
                        "favourites_count" : 758,
 +
                        "city" : "1",
 +
                        "description" : "冯大辉,工作在丁香园( http://dxy.com , 医药生命科学专业网站),CTO。多年来一直做技术,说起来,也是个手艺人。Twitter 是我的主战场。",
 +
                        "verified" : true,
 +
                        "id" : 1577826897,
 +
                        "gender" : "m",
 +
                        "friends_count" : 1994,
 +
                        "screen_name" : "Fenng",
 +
                        "allow_all_act_msg" : false,
 +
                        "following" : false,
 +
                        "url" : "http://dbanotes.net",
 +
                        "profile_image_url" : "http://tp2.sinaimg.cn/1577826897/50/1283204066/1",
 +
                        "created_at" : "Fri Aug 28 00:00:00 +0800 2009",
 +
                        "province" : "33",
 +
                        "location" : "浙江 杭州"
 +
                    },
 +
                    "favorited" : false,
 +
                    "in_reply_to_user_id" : "",
 +
                    "id" : 4420179987,
 +
                    "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
 +
                },
 +
                 "in_reply_to_status_id" : "",
 +
                 "in_reply_to_screen_name" : "",
 +
                 "geo" : null,
 +
                "favorited" : false,
 +
                 "in_reply_to_user_id" : "",
 +
                "id" : 4420481591,
 +
                 "source" : "<a href=\"http://wing.uedsite.com/\" rel=\"nofollow\">Wing微博2010</a>"
 +
            },
 +
            "id" : 1477356933,
 +
            "gender" : "m",
 +
            "friends_count" : 1158,
 +
             "screen_name" : "liudaoru",
 +
             "allow_all_act_msg" : false,
 +
            "following" : false,
 +
             "url" : "http://blog.sina.com.cn/liudaoru",
 +
             "profile_image_url" : "http://tp2.sinaimg.cn/1477356933/50/1279879139/1",
 +
            "created_at" : "Thu Jan 21 00:00:00 +0800 2010",
 +
            "province" : "11",
 +
            "location" : "北京 海淀区"
 
         }
 
         }
     }
+
     },
 +
    ...
 
]
 
]
 
+
</pre>|
</pre>
+
useAge=无|
 
+
otherInfo=
=== 使用示例===
+
}}
 
+
* xml:
+
# curl -u uid:password http://api.t.sina.com.cn/users/suggestions.xml?source=appkey
+
# curl -u uid:password http://api.t.sina.com.cn/users/suggestions.xml?cursor=-1&source=appkey
+
 
+
* json:
+
# curl -u uid:password http://api.t.sina.com.cn/users/suggestions.json?source=appkey
+
# curl -u uid:password http://api.t.sina.com.cn/users/suggestions.json?cursor=-1&source=appkey
+

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

目录

users/suggestions

返回当前用户可能感兴趣的用户。

URL

http://api.t.sina.com.cn/users/suggestions.(json%7Cxml)

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

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

请求数限制

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

请求参数

  必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)
with_reason false int 是否返回推荐原因,可选值1/0。当值为1,返回结果中增加推荐原因,会大幅改变返回值格式。

注意事项

返回结果

XML示例(with_reason=0)

<?xml version="1.0" encoding="UTF-8"?>
<users>
  <user>
    <id>1477356933</id>
    <screen_name>liudaoru</screen_name>
    <name>liudaoru</name>
    <province>11</province>
    <city>8</city>
    <location>北京 海淀区</location>
    <description>80后,IT民工,总是富有各种想法,素以能折腾而闻名。。。</description>
    <url>http://blog.sina.com.cn/liudaoru</url>
    <profile_image_url>http://tp2.sinaimg.cn/1477356933/50/1279879139/1</profile_image_url>
    <domain>liudaoru</domain>
    <gender>m</gender>
    <followers_count>787</followers_count>
    <friends_count>1158</friends_count>
    <statuses_count>1401</statuses_count>
    <favourites_count>509</favourites_count>
    <created_at>Thu Jan 21 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>
    <status>
      <created_at>Mon Dec 13 17:05:41 +0800 2010</created_at>
      <id>4420481591</id>
      <text>转发微博</text>
      <source>
        <a href="http://wing.uedsite.com/">Wing微博2010</a>
      </source>
      <favorited>false</favorited>
      <truncated>false</truncated>
      <geo/>
      <in_reply_to_status_id/>
      <in_reply_to_user_id/>
      <in_reply_to_screen_name/>
      <retweeted_status>
        <created_at>Mon Dec 13 16:51:54 +0800 2010</created_at>
        <id>4420179987</id>
        <text>刚才浙江电信的工程师来给我安装调试ADSL,前后浪费我了两个多小时不说,看到业务流程处理之乱、服务态度之烂实在是叹为观止,无以复加。@浙江电信客服</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>1577826897</id>
          <screen_name>Fenng</screen_name>
          <name>Fenng</name>
          <province>33</province>
          <city>1</city>
          <location>浙江 杭州</location>
          <description>冯大辉,工作在丁香园( http://dxy.com , 医药生命科学专业网站),CTO。多年来一直做技术,说起来,也是个手艺人。Twitter 是我的主战场。</description>
          <url>http://dbanotes.net</url>
          <profile_image_url>http://tp2.sinaimg.cn/1577826897/50/1283204066/1</profile_image_url>
          <domain>fenng</domain>
          <gender>m</gender>
          <followers_count>50394</followers_count>
          <friends_count>1994</friends_count>
          <statuses_count>2302</statuses_count>
          <favourites_count>758</favourites_count>
          <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
          <following>false</following>
          <verified>true</verified>
          <allow_all_act_msg>false</allow_all_act_msg>
          <geo_enabled>true</geo_enabled>
        </user>
        <annotations/>
      </retweeted_status>
    </status>
  </user>
  ...
</users>

JSON示例(with_reason=0)

[
    {
        "name" : "liudaoru",
        "domain" : "liudaoru",
        "geo_enabled" : true,
        "followers_count" : 787,
        "statuses_count" : 1401,
        "favourites_count" : 509,
        "city" : "8",
        "description" : "80后,IT民工,总是富有各种想法,素以能折腾而闻名。。。",
        "verified" : false,
        "status" : 
        {
            "created_at" : "Mon Dec 13 17:05:41 +0800 2010",
            "text" : "转发微博",
            "truncated" : false,
            "retweeted_status" : 
            {
                "created_at" : "Mon Dec 13 16:51:54 +0800 2010",
                "text" : "刚才浙江电信的工程师来给我安装调试ADSL,前后浪费我了两个多小时不说,看到业务流程处理之乱、服务态度之烂实在是叹为观止,无以复加。@浙江电信客服",
                "truncated" : false,
                "in_reply_to_status_id" : "",
                "annotations" : 
                [

                ],
                "in_reply_to_screen_name" : "",
                "geo" : null,
                "user" : 
                {
                    "name" : "Fenng",
                    "domain" : "fenng",
                    "geo_enabled" : true,
                    "followers_count" : 50394,
                    "statuses_count" : 2302,
                    "favourites_count" : 758,
                    "city" : "1",
                    "description" : "冯大辉,工作在丁香园( http://dxy.com , 医药生命科学专业网站),CTO。多年来一直做技术,说起来,也是个手艺人。Twitter 是我的主战场。",
                    "verified" : true,
                    "id" : 1577826897,
                    "gender" : "m",
                    "friends_count" : 1994,
                    "screen_name" : "Fenng",
                    "allow_all_act_msg" : false,
                    "following" : false,
                    "url" : "http://dbanotes.net",
                    "profile_image_url" : "http://tp2.sinaimg.cn/1577826897/50/1283204066/1",
                    "created_at" : "Fri Aug 28 00:00:00 +0800 2009",
                    "province" : "33",
                    "location" : "浙江 杭州"
                },
                "favorited" : false,
                "in_reply_to_user_id" : "",
                "id" : 4420179987,
                "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
            },
            "in_reply_to_status_id" : "",
            "in_reply_to_screen_name" : "",
            "geo" : null,
            "favorited" : false,
            "in_reply_to_user_id" : "",
            "id" : 4420481591,
            "source" : "<a href=\"http://wing.uedsite.com/\" rel=\"nofollow\">Wing微博2010</a>"
        },
        "id" : 1477356933,
        "gender" : "m",
        "friends_count" : 1158,
        "screen_name" : "liudaoru",
        "allow_all_act_msg" : false,
        "following" : false,
        "url" : "http://blog.sina.com.cn/liudaoru",
        "profile_image_url" : "http://tp2.sinaimg.cn/1477356933/50/1279879139/1",
        "created_at" : "Thu Jan 21 00:00:00 +0800 2010",
        "province" : "11",
        "location" : "北京 海淀区"
    },
    ...
]

XML示例(with_reason=1)

<?xml version="1.0" encoding="UTF-8"?>
<suggested_users>
  <suggested_user>
    <reason>area</reason>
    <user>
      <id>1477356933</id>
      <screen_name>liudaoru</screen_name>
      <name>liudaoru</name>
      <province>11</province>
      <city>8</city>
      <location>北京 海淀区</location>
      <description>80后,IT民工,总是富有各种想法,素以能折腾而闻名。。。</description>
      <url>http://blog.sina.com.cn/liudaoru</url>
      <profile_image_url>http://tp2.sinaimg.cn/1477356933/50/1279879139/1</profile_image_url>
      <domain>liudaoru</domain>
      <gender>m</gender>
      <followers_count>787</followers_count>
      <friends_count>1158</friends_count>
      <statuses_count>1401</statuses_count>
      <favourites_count>509</favourites_count>
      <created_at>Thu Jan 21 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>
      <status>
        <created_at>Mon Dec 13 17:05:41 +0800 2010</created_at>
        <id>4420481591</id>
        <text>转发微博</text>
        <source>
          <a href="http://wing.uedsite.com/">Wing微博2010</a>
        </source>
        <favorited>false</favorited>
        <truncated>false</truncated>
        <geo/>
        <in_reply_to_status_id/>
        <in_reply_to_user_id/>
        <in_reply_to_screen_name/>
        <retweeted_status>
          <created_at>Mon Dec 13 16:51:54 +0800 2010</created_at>
          <id>4420179987</id>
          <text>刚才浙江电信的工程师来给我安装调试ADSL,前后浪费我了两个多小时不说,看到业务流程处理之乱、服务态度之烂实在是叹为观止,无以复加。@浙江电信客服</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>1577826897</id>
            <screen_name>Fenng</screen_name>
            <name>Fenng</name>
            <province>33</province>
            <city>1</city>
            <location>浙江 杭州</location>
            <description>冯大辉,工作在丁香园( http://dxy.com , 医药生命科学专业网站),CTO。多年来一直做技术,说起来,也是个手艺人。Twitter 是我的主战场。</description>
            <url>http://dbanotes.net</url>
            <profile_image_url>http://tp2.sinaimg.cn/1577826897/50/1283204066/1</profile_image_url>
            <domain>fenng</domain>
            <gender>m</gender>
            <followers_count>50394</followers_count>
            <friends_count>1994</friends_count>
            <statuses_count>2302</statuses_count>
            <favourites_count>758</favourites_count>
            <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
            <following>false</following>
            <verified>true</verified>
            <allow_all_act_msg>false</allow_all_act_msg>
            <geo_enabled>true</geo_enabled>
          </user>
          <annotations/>
        </retweeted_status>
      </status>
    </user>
  </suggested_user>
  ...
</suggested_users>

JSON示例(with_reason=1)

[
    {
        "reason" : "area",
        "user" : 
        {
            "name" : "liudaoru",
            "domain" : "liudaoru",
            "geo_enabled" : true,
            "followers_count" : 787,
            "statuses_count" : 1401,
            "favourites_count" : 509,
            "city" : "8",
            "description" : "80后,IT民工,总是富有各种想法,素以能折腾而闻名。。。",
            "verified" : false,
            "status" : 
            {
                "created_at" : "Mon Dec 13 17:05:41 +0800 2010",
                "text" : "转发微博",
                "truncated" : false,
                "retweeted_status" : 
                {
                    "created_at" : "Mon Dec 13 16:51:54 +0800 2010",
                    "text" : "刚才浙江电信的工程师来给我安装调试ADSL,前后浪费我了两个多小时不说,看到业务流程处理之乱、服务态度之烂实在是叹为观止,无以复加。@浙江电信客服",
                    "truncated" : false,
                    "in_reply_to_status_id" : "",
                    "annotations" : 
                    [

                    ],
                    "in_reply_to_screen_name" : "",
                    "geo" : null,
                    "user" : 
                    {
                        "name" : "Fenng",
                        "domain" : "fenng",
                        "geo_enabled" : true,
                        "followers_count" : 50394,
                        "statuses_count" : 2302,
                        "favourites_count" : 758,
                        "city" : "1",
                        "description" : "冯大辉,工作在丁香园( http://dxy.com , 医药生命科学专业网站),CTO。多年来一直做技术,说起来,也是个手艺人。Twitter 是我的主战场。",
                        "verified" : true,
                        "id" : 1577826897,
                        "gender" : "m",
                        "friends_count" : 1994,
                        "screen_name" : "Fenng",
                        "allow_all_act_msg" : false,
                        "following" : false,
                        "url" : "http://dbanotes.net",
                        "profile_image_url" : "http://tp2.sinaimg.cn/1577826897/50/1283204066/1",
                        "created_at" : "Fri Aug 28 00:00:00 +0800 2009",
                        "province" : "33",
                        "location" : "浙江 杭州"
                    },
                    "favorited" : false,
                    "in_reply_to_user_id" : "",
                    "id" : 4420179987,
                    "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
                },
                "in_reply_to_status_id" : "",
                "in_reply_to_screen_name" : "",
                "geo" : null,
                "favorited" : false,
                "in_reply_to_user_id" : "",
                "id" : 4420481591,
                "source" : "<a href=\"http://wing.uedsite.com/\" rel=\"nofollow\">Wing微博2010</a>"
            },
            "id" : 1477356933,
            "gender" : "m",
            "friends_count" : 1158,
            "screen_name" : "liudaoru",
            "allow_all_act_msg" : false,
            "following" : false,
            "url" : "http://blog.sina.com.cn/liudaoru",
            "profile_image_url" : "http://tp2.sinaimg.cn/1477356933/50/1279879139/1",
            "created_at" : "Thu Jan 21 00:00:00 +0800 2010",
            "province" : "11",
            "location" : "北京 海淀区"
        }
    },
    ...
]

其他

文档更新时间: 2012-09-24