C/2/place/nearby users/list/biz-en

跳转到: 导航, 搜索

place/nearby_users/list/biz

Return users nearby.

URL

https://c.api.weibo.com/2/place/nearby_users/list/biz.json

Supported Formats

JSON

HTTP Request Method

GET

Requires Login

true
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.
lat true float Latitude when publish, range from -90.0 to +90.0, in which '+' means North, default as 0.0.
long true float Longitude when publish, range from -180.0 to +180.0, in which '+' means East, default as 0.0
count false int Records returned within one page, maximum 50, default as 20.
page false int The page number of returned results, defaults as 1.
range false int Radius range of search, default as 2000, maximum 11132, unit meter.
sort false int Sort method, 0 for time, 1 for distance, 2 for social relationship, default as 2.
filter false int (Temporary disabled) Users relationship filtering, 0 for all, 1 for strangers, 2 for followings, default as 0.
gender false int Gender filtering, 0 for all, 1 for male, 2 for female, default as 0.
level false int User level filtering, 0 for all, 1 for regular user, 2 for VIP user, 7 for master user, default as 0.
startbirth false int Working with parameter endbirth to filter age, valued for users' age, default as null.
endbirth false int Working with parameter startbirth to filter age, valued for users' age, default as null.
offset false int Whether lat and long numbers are calibrated, 0 for false, 1 for true, default as 0.

Notes

none

Response

JSON Example

//成功返回
{
    "users": [
        {
            "id": "2702966545",
            "idstr": "2702966545",
            "screen_name": "CiCi丶红",
            "name": "CiCi丶红",
            "province": "33",
            "city": "1",
            "location": "浙江 杭州",
            "description": "",
            "url": "",
            "profile_image_url": "http://tp2.sinaimg.cn/2702966545/50/5628863789/1",
            "profile_url": "u/2702966545",
            "domain": "",
            "weihao": "",
            "gender": "m",
            "followers_count": 0,
            "friends_count": 0,
            "statuses_count": 1,
            "favourites_count": 0,
            "created_at": "Sun Apr 08 00:00:00 +0800 2012",
            "following": false,
            "allow_all_act_msg": false,
            "geo_enabled": true,
            "verified": false,
            "verified_type": -1,
            "remark": "",
            "allow_all_comment": true,
            "avatar_large": "http://tp2.sinaimg.cn/2702966545/180/5628863789/1",
            "verified_reason": "",
            "follow_me": false,
            "online_status": 0,
            "bi_followers_count": 0,
            "lang": "zh-cn",
            "distance": 1300,
            "last_at": "2012-04-09 22:37:44",
            "lon": "120.008758",
            "lat": "30.008058"
        },
        ...
    ],
    "total_number": 11,
    "states": [
        {
            "id": "1076063077",
            "state": 7
        },
        ...
    ]
}
//失败返回
{
    "request": "/place/nearby_users/list/biz.json",
    "error_code": XXXXX,
    "error": "error message."
}

See the Error Code Description for the error information details.

Field Description

none

Others

none

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


文档更新时间: 2015-07-23
api评价