Weibo Platform Logo

微博开放平台

weibo

Users/suggestions

跳转到： 导航, 搜索

目录

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" : "北京 海淀区"
        }
    },
    ...
]

其他

无

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

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

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