跳转到: 导航, 搜索


Publish a post.



Supported Formats


HTTP Request Method


Requires Login

See the Login and Authorization Mechanism Statement for login and authorization details.

Requests Count Limitation

Request all APIs:

    • 50000/hour/IP;

Request Parameters

  Requires Type and Range Description
source false string This parameter is not needed when using OAuth.The value of this parameter is the AppKey.
access_token false string This parameter is required when using OAuth.You will get the access_token after oauth authorization.
status true string Text content to be published, must be URL encoded.
visible false int The visibility of the post, 0 for everyone, 1 for oneself, 2 for close friend, 3 for designated group, default as 0.
list_id false string Desiganated group ID to which post visible to, required and effective only when parameter visible is 3.
lat false float Latitude, range from -90.0 to +90.0, in which '+' means North, default as 0.0.
long false float Longitude, range from -180.0 to +180.0, in which '+' means East, default as 0.0.
annotations false string Metadata, for third party application record necessary information. Each post contains one or more metadata, in json format, and no more than 512 characters, content could be self-defined.
rip false string The real user IP address reported by the developer, formatted like:
is_longtext false int whether to post a status with more than 140 characters ,0:less than 140 characters,1:more than 140 characters but less than 2000 characters,default value is 0.


  • Two consecutive posts could not be the same;
  • Non-member user can only publish directed post to group less than 200 people.


JSON Example

    "created_at": "Wed Oct 24 23:39:10 +0800 2012",
    "id": 3504801050130000,
    "mid": "3504801050130827",
    "idstr": "3504801050130827",
    "text": "定向分组内容。",
    "source": "新浪微博</a>",
    "favorited": false,
    "truncated": false,
    "in_reply_to_status_id": "",
    "in_reply_to_user_id": "",
    "in_reply_to_screen_name": "",
    "geo": {
        "type": "Point",
        "coordinates": [
    "user": {
        "id": 1902538057,
        "idstr": "1902538057",
        "screen_name": "张三",
        "name": "张三",
        "province": "11",
        "city": "8",
        "location": "北京 海淀区",
        "description": "做最受尊敬的互联网产品经理...",
        "url": "",
        "profile_image_url": "http://tp2.sinaimg.cn/1902538057/50/22817372040/1",
        "profile_url": "304270168",
        "domain": "shenbinzhu",
        "weihao": "304270168",
        "gender": "m",
        "followers_count": 337,
        "friends_count": 534,
        "statuses_count": 516,
        "favourites_count": 60,
        "created_at": "Sat Dec 25 14:12:35 +0800 2010",
        "following": false,
        "allow_all_act_msg": true,
        "geo_enabled": true,
        "verified": false,
        "verified_type": 220,
        "allow_all_comment": true,
        "avatar_large": "http://tp2.sinaimg.cn/1902538057/180/22817372040/1",
        "verified_reason": "",
        "follow_me": false,
        "online_status": 0,
        "bi_followers_count": 185,
        "lang": "zh-cn",
        "level": 7,
        "type": 1,
        "ulevel": 0,
        "badge": {
            "kuainv": {
                "level": 0
            "uc_domain": 0,
            "enterprise": 0,
            "anniversary": 0
    "annotations": [
            "aa": "cc"
    "reposts_count": 0,
    "comments_count": 0,
    "attitudes_count": 0,
    "mlevel": 0,
    "visible": {
        "type": 3,
        "list_id": 3469454702570000
    "request": "/statuses/update/biz.json",
    "error_code": XXXXX,
    "error": "error message."

See the Error Code Description for the error information details.

Field Description




Language: [[{{{2/uri}}}|中文]]

文档更新时间: 2017-11-13