Users/suggestions/en

Jump to: navigation, search

Contents

users/suggestions

Returns some user that authentication user may be interesting in

URL

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

Supported Formats

XML/JSON

HTTP Request Method

GET

Requires Authentication

true
See the Authorization Mechanism Statement for authorization details

Requests Count Limitation

true
See the Interface Access Rights Statement for the Request Count Limitaiton details.

Request Parameters

  Requires Type and Range Description
source true string AppKey for the application to identify it. ( This parameter is not needed when using OAuth)
with_reason false int whether has reason, can be 1 or 0。1 means response includes the reason.

Notes

None

Example Request

XML
curl -u "username:password" "http://api.t.sina.com.cn/users/suggestions.xml?source=appkey&with_reason=1"
JSON
curl -u "username:password" "http://api.t.sina.com.cn/users/suggestions.json?source=appkey&with_reason=1"

Response

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

Others

None

文档更新时间: 21 January 2011