Jump to: navigation, search



Returns user profile and the latest weibo of the user by his ID or nickname.


Supported Formats


HTTP Request Method


Requires Authentication

See the Authorization Mechanism Statement for authorization details

Requests Count Limitation

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)
:id false int64/string User ID(int64) or nickname(string). This is a RESTful parameter. Call example see Notes.
user_id false int64 Return the weibos of specified ID of a user. It is mainly used to distinguish user ID with weibo nickname(screen_name). When weibo nickname is numbers and leads ambiguity with user ID, especially when weibo nickname and user ID are the same, using this parameter is recommended.
screen_name false string Weibo nickname. It is mainly used to distinguish user UID and weibo nickname. When they both are the same and lead ambiguity, using this parameter is recommended.
:id, user_id, screen_name, at least one of these three parameter should be provided.


  •  :id is a RESTful parameter. The URL of using this parameter is:
Sample Codes:

  • It returns 400 error with "40023:Error: User does not exists!" if user ID or nickname don’t exist.
  • If none of the three parameters is provided, it returns 400 error. If it recognizes a unknown user ID, the it return with warnning “40023:Error: User does not exists!"
  • To protect user privacy, only public data or open data to follower user is returned.

Example Request

curl -u "username:password" ""
curl -u "username:password" ""


XML Example

<?xml version="1.0" encoding="UTF-8"?>
  <location>北京 海淀区</location>
  <created_at>Wed Jan 20 00:00:00 +0800 2010</created_at>
    <created_at>Mon Nov 29 16:08:43 +0800 2010</created_at>
    <text>各位开发者,我们的论坛上线啦~ 欢迎大家的参与~另外,关于技术相关的问题,可以在论坛上提出,也可以@微博API 这个官方技术支持账号哦~感谢大家对开放平台的支持~[呵呵]</text>
      <a href="">新浪微博</a>

JSON Example

    "name" : "微博开放平台",
    "domain" : "openapi",
    "geo_enabled" : true,
    "followers_count" : 13247,
    "statuses_count" : 158,
    "favourites_count" : 0,
    "city" : "8",
    "description" : "新浪微博开放平台市场推广官方账号,如有技术问题,请@微博API或者发私信给微博API",
    "verified" : true,
    "status" : 
        "created_at" : "Mon Nov 29 16:08:43 +0800 2010",
        "text" : "各位开发者,我们的论坛上线啦~ 欢迎大家的参与~另外,关于技术相关的问题,可以在论坛上提出,也可以@微博API 这个官方技术支持账号哦~感谢大家对开放平台的支持~[呵呵]",
        "truncated" : false,
        "in_reply_to_status_id" : "",
        "in_reply_to_screen_name" : "",
        "geo" : null,
        "favorited" : false,
        "in_reply_to_user_id" : "",
        "id" : 3958728723,
        "source" : "<a href=\"\" rel=\"nofollow\">新浪微博</a>"
    "id" : 11051,
    "gender" : "m",
    "friends_count" : 5,
    "screen_name" : "微博开放平台",
    "allow_all_act_msg" : true,
    "following" : false,
    "url" : "",
    "profile_image_url" : "",
    "created_at" : "Wed Jan 20 00:00:00 +0800 2010",
    "province" : "11",
    "location" : "北京 海淀区"

Field Description - user

  • id: User ID
  • screen_name: User’s nickname displayed on the home page
  • name: Friendly displayed name, the same as screen_name
  • province: Province code ( see Province and city code table)
  • city: City code ( see Province and city code table)
  • location:Address
  • description: Personal description
  • url: Url of the user’s blog
  • profile_image_url: Profile image
  • domain: The user’s personalized weibo url
  • gender: Gender, m—male, f- - female, n-- unknown
  • followers_count: Followers count
  • friends_count: Following count
  • statuses_count: Weibo count
  • favourites_count: Favorites count
  • created_at: Created time
  • following: Whether the current user is following the user that posts the weibo (Not supported yet)
  • verified: Whether the user is verified by his real identity, marked with “V”

Field Description - weibo

  • created_at: Create time
  • id: Weibo ID
  • text: Weibo content
  • source: Weibo source
  • favorited: Whether it is favroited
  • truncated: Whether it is truncated
  • in_reply_to_status_id: The reply’s ID
  • in_reply_to_user_id: UID of the replyer
  • in_reply_to_screen_name: Nickname of replyer
  • thumbnail_pic: Thumbnail picture
  • bmiddle_pic: Medium picture
  • original_pic:Original picture
  • user: User profile
  • retweeted_status: eposted weibo content, the content is the status, This filed is only available for a reposted weibo.


Java Example

Please download Java SDK from . Weibo SDK Development Kit Dowload Site
Sample Code:

package weibo4j.examples;

import weibo4j.User;
import weibo4j.Weibo;
import weibo4j.WeiboException; 

public class GetUserInfo {

	 * 根据用户ID获取用户资料(授权用户) 
	 * @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 {
			User user = getWeibo(true,args).showUser(args[2]);
		} catch (WeiboException e) {
	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 {//用户登录方式
		return weibo;

PHP Example

Please download PHP SDK with OAUTH supported from Weibo SDK Development Kit Dowload Site
. Sample Code:

$c = new WeiboClient( WB_AKEY , 
                      WB_SKEY , 
                      $_SESSION['last_key']['oauth_token'] , 
                      $_SESSION['last_key']['oauth_token_secret']  );
$u_id = "u_id";
$msg = $c->show_user($u_id);
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;
echo($msg['id'].' : '.$msg['name'].'  '.$msg['created_at']);

文档更新时间: 20 January 2011