Jump to: navigation, search



Returns the details about the following status between two users.


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)
The following parameters are not required. If left empty, the default user is theauthenticating user.
source_id false int64 the user_id of the subject user.
source_screen_name false string screen name of the subject user.
One of the following is required.
target_id false int64 The user_id of the target user.
target_screen_name false string The screen name of the target user.


  • If current user is authenticated, this API will automaticly treat the current user’s ID as source_id. But it can be assigned a different user id by by force to test the relationship.
  • It returns HTTP 400 error, if the subject or target user does not exist,
  • <blocking> means whether the source user is blocking the target user. Available only when source_id is current user, that is user can only view his own blockings. ( blocking protocol temporarily does not support return.)


=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->is_followed($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;
if (isset($msg['target'])){
	if (isset($msg['target']['followed_by'])){
		if ($msg['target']['followed_by'] === true){
			echo "Target is followed: true";
		} else {
			echo "Target is followed: false";

Example Request

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


XML Example

<?xml version="1.0" encoding="UTF-8"?>

JSON Example




文档更新时间: 20 January 2011