Status API

Read API

• statuses/public_timeline Return the latest public weibos
• statuses/friends_timeline Return the authenticating user’s and his friends’ latest weibos
• statuses/home_timeline Return the authenticating user’s and his friends’ latest weibos
• statuses/friends_timeline/ids Return the authenticating user’s and his friends’ latest weibos'ID
• statuses/user_timeline Return the authenticating user’s latest weibos
• statuses/user_timeline/ids Return the authenticating user’s latest weibos'IDNew!
• statuses/repost_timeline Return the latest of repost weibos of a original weibo
• statuses/repost_timeline/ids Return the latest of repost weibos'ID of a original weiboNew!
• statuses/repost_by_me Return the latest repost weibos of authenticating user
• statuses/mentions Return the authenticating user’s mentions
• statuses/mentions/ids Return the authenticating user’s mentions'IDNew!
• statuses/bilateral_timeline Return the user's latest weibos that followed the authenticating user and is followed by the authenticating userNew!
• statuses/show Return the single weibo’s content by its ID
• statuses/querymid Return the mid by ID
• statuses/queryid Return the ID by mid
• statuses/hot/repost_daily
• statuses/hot/repost_weekly
• statuses/hot/comments_daily
• statuses/hot/comments_weekly
• statuses/count Return the comment counts and repost counts of a list of weibos

Write API

• statuses/repost Repost a weibo
• statuses/destroy Delete a weibo
• statuses/update Post a weibo
• statuses/upload Post a weibo with picture
• statuses/upload_url_text
• emotions Emotion Iinterface, return the emotion list

Comment API

Read API

• comments/show
• comments/by_me
• comments/to_me
• comments/timeline
• comments/mentions
• comments/show_batch

Write API

• comments/create
• comments/destroy
• comments/destroy_batch
• comments/reply

User API

Read API

• users/show Return user profile by user IDNew!
• users/domain_show
• users/counts

Friendship API

Friend Read API

• friendships/friends
• friendships/friends/in_common
• friendships/friends/bilateral
• friendships/friends/bilateral/ids
• friendships/friends/ids

Follower Read API

• friendships/followers
• friendships/followers/ids
• friendships/followers/active

Friendship Chain Read API

• friendships/friends_chain/followers

Friendship Read API

• friendships/show Return relationship of two users

Write API

• friendships/create Follow a user
• friendships/destroy Unfollow a user
• friendships/remark/update

Account API

Read API

• account/profile/basic
• account/profile/education
• account/profile/career
• account/get_privacy
• account/profile/school_list
• account/rate_limit_status
• account/get_uid

Write API

• account/end_session End the session of authenticating user
• account/profile/basic_update
• account/profile/edu_update
• account/profile/edu_destroy
• account/profile/car_update
• account/profile/car_destroy
• account/avatar/upload
• account/update_privacy

Favorite API

Read API

• favorites Return authenticating user’s favorites list
• favorites/ids
• favorites/show
• favorites/by_tags
• favorites/tags
• favorites/by_tags/ids

Write API

• favorites/create Add a weibo as favorite
• favorites/destroy Delete a weibo from favorite list of the authenticating user
• favorites/destroy_batch Delete a batch of weibos from favorite list
• favorites/tags/update
• favorites/tags/update_batch
• favorites/tags/destroy_batch

Trend API

Read API

• trends Returns trends of a user
• trends/is_follow
• trends/statuses Returns the weibos belong to the trends
• trends/hourly Hot trends by hour
• trends/daily Return trends by date
• trends/weekly Return trends by week

Write API

• trends/follow Follow a trends
• trends/destroy Unfollow a trends

Tag API

Read API

Write API

• user/statuses/id Jump to the content page of weibo by its ID and user ID.

• statuses/friends Return the user’s following list and the latest weibo of each following user
• statuses/followers Return the user’s follower list and the latest weibo of each follower
• users/hot Return system recommended users
• user/friends/update_remark Update remarks of authenticating user's followingNew!
• users/suggestions Return the user that authenticating user may be interesting inBeta!

Direct message API

• direct_messages Return the authenticating user’s latest direct message list
• direct_messages/sent Return latest direct message list sent by the authenticating user
• direct_messages/new Send a direct message
• direct_messages/destroy/:id Delete a specific direct message
• direct_messages/destroy_batch Delete a batch of direct messages

Friendships API

• friendships/exists Check if already follow a user (Recommend to use friendships/show instead)

Social Graph API

• friends/ids Return user’s following list
• followers/ids Return user’s follower list

Privacy API [NEW]

• account/update_privacy Set privacy parameters
• account/get_privacy Return current user’s privacy settings

Block API [NEW]

• blocks/create Block a user
• blocks/destroy Unblock a user
• blocks/exists Check whether a user is in blocked
• blocks/blocking Return the blocked users list with detail
• blocks/blocking/ids Return the user IDs of blocking list in pages

Tags API [NEW]

• tags Return the tag list by user ID
• tags/create Create a tag for current user
• tags/suggestions Return the recommended tags for the current user
• tags/destroy Delete a tag
• tags/destroy_batch Delete a batch of tags

• account/verify_credentials Check if the user is authenticated
• account/rate_limit_status Return the authenticating user’s API access rate limitation

• account/update_profile_image Update profile image
• account/update_profile Update profile
• account/register Register a Sina Weibo account
• account/activate Activate a weibo account

OAuth API

• oauth about OAuth
• oauth/request_token Return unauthorized Request Token
• oauth/authorize Request Authorization Token.n
• oauth/access_token Get the Access Token by Request Token

*xAuth about xAuth

Search API

Note: The Search API currently is not available for all the developers. please contact @微博开放平台 or email us at weibo_app@vip.sina.com for more info.

User search

• users/search Search for weibo users Updated!

Weibo Search API

• search Search for weibo content
• statuses/search Search for weibo contents by multi-conditions

Geo API

Geo API is not available for all developers. Any questions, please contact @地理信息开放平台, or email us at weibo_app@vip.sina.com for more info.

Geo search API

• location/route Search for car driving route
• location/bus Search for bus interchange info

Geo transformation API

• location/ip2xy Return the coordinated longitude and langtitude by IP address
• location/addr2xy Return the coordinated longitude and langtitude by the street address
• location/get_addr Return the street address of the specific longitude and langtitude

Test API

• help/test Test API

Appendix

Rest API Field Description

• status weibo content area
• user user profile area
• comment comment of a weibo
• direct_message direct message
• Province and city code table
• Metadata metadata New!

Geo field description

• location/citycode City code table
• location/citycode_bus City code table that has bus information
• location/category Category table