注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 淘宝用户API

taobao.user.seller.get (查询卖家用户信息)

查询卖家用户信息(只能查询有店铺的用户) 只能卖家类应用调用。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String [] 必须 nick,sex
  • 最大列表长度:200
  • 需要返回的字段列表,可选值为返回示例值中的可以看到的字段

    响应参数

    名称 类型 示例值 描述
    user User 用户
    • └ user_id
    • Number
    • 10001
    • 用户数字ID
    • └ nick
    • String
    • hz0799
    • 用户昵称
    • └ sex
    • String
    • m
    • 性别。可选值:m(男),f(女)
    • seller_credit
    • UserCredit
    • 卖家信用
    • └ level
    • Number
    • 1
    • 信用等级(是根据score生成的),信用等级:淘宝会员在淘宝网上的信用度,分为20个级别,级别如:level = 1 时,表示一心;level = 2 时,表示二心
    • └ score
    • Number
    • 1
    • 信用总分(“好评”加一分,“中评”不加分,“差评”扣一分。分越高,等级越高)
    • └ total_num
    • Number
    • 1
    • 收到的评价总条数。取值范围:大于零的整数
    • └ good_num
    • Number
    • 1
    • 收到的好评总条数。取值范围:大于零的整数
    • └ type
    • String
    • B
    • 用户类型。可选值:B(B商家),C(C商家)
    • └ has_more_pic
    • Boolean
    • true
    • 是否购买多图服务。可选值:true(是),false(否)
    • └ item_img_num
    • Number
    • 5
    • 可上传商品图片数量
    • └ item_img_size
    • Number
    • 1024
    • 单张商品图片最大容量(商品主图大小)。单位:k
    • └ prop_img_num
    • Number
    • 5
    • 可上传属性图片数量
    • └ prop_img_size
    • Number
    • 1024
    • 单张销售属性图片最大容量(非主图的商品图片和商品属性图片)。单位:k
    • └ auto_repost
    • String
    • unlimited
    • 是否受限制。可选值:limited(受限制),unlimited(不受限)
    • └ promoted_type
    • String
    • authentication
    • 有无实名认证。可选值:authentication(实名认证),not authentication(没有认证)
    • └ status
    • String
    • normal
    • 状态。可选值:normal(正常),inactive(未激活),delete(删除),reeze(冻结),supervise(监管)
    • └ alipay_bind
    • String
    • bind
    • 有无绑定。可选值:bind(绑定),notbind(未绑定)
    • └ consumer_protection
    • Boolean
    • true
    • 是否参加消保
    • └ vip_info
    • String
    • v1
    • 用户的全站vip信息,可取值如下:c(普通会员),asso_vip(荣誉会员),vip1,vip2,vip3,vip4,vip5,vip6(六个等级的正式vip会员),共8种取值,其中asso_vip是由vip会员衰退而成,与主站上的vip0对应。
    • └ magazine_subscribe
    • Boolean
    • true
    • 是否订阅了淘宝天下杂志
    • └ vertical_market
    • String
    • 3C,shoes
    • 用户参与垂直市场类型。shoes表示鞋城垂直市场用户,3C表示3C垂直市场用户。多个类型之间用","分隔。如:一个用户既是3C用户又是鞋城用户,那么这个字段返回就是"3C,shoes"。如果用户不是垂直市场用户,此字段返回为""。
    • └ avatar
    • String
    • http://assets.taobaocdn.com/app/sns/img/default/avatar-120.png
    • 用户头像地址
    • └ online_gaming
    • Boolean
    • true
    • 用户是否为网游用户,属于隐私信息,需要登陆才能查看自己的。 目前仅供taobao.user.get使用
    • └ liangpin
    • Boolean
    • true
    • 是否是无名良品用户,true or false
    • └ sign_food_seller_promise
    • Boolean
    • true
    • 卖家是否签署食品卖家承诺协议
    • └ has_shop
    • Boolean
    • true
    • 用户作为卖家是否开过店
    • └ is_lightning_consignment
    • Boolean
    • true
    • 是否24小时闪电发货(实物类)
    • └ has_sub_stock
    • Boolean
    • true
    • 表示用户是否具备修改商品减库存逻辑的权限(一共有拍下减库存和付款减库存两种逻辑) 值含义: 1)true:是 2)false:否。
    • └ is_golden_seller
    • Boolean
    • true
    • 用户是否是金牌卖家
    • └ is_tjb_seller
    • Boolean
    • false
    • 是否是特价版商家,需要field查询
    • └ displaynick
    • String
    • displayNIck001
    • 用户展示昵称,不唯一,可被修改
    • └ open_uid
    • String
    • adflajfaf
    • openuid

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    UserSellerGetRequest req = new UserSellerGetRequest();
    req.setFields("nick,sex");
    UserSellerGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <user_seller_get_response>
        <user>
            <user_id>10001</user_id>
            <nick>hz0799</nick>
            <sex>m</sex>
            <seller_credit>
                <level>1</level>
                <score>1</score>
                <total_num>1</total_num>
                <good_num>1</good_num>
            </seller_credit>
            <type>B</type>
            <has_more_pic>true</has_more_pic>
            <item_img_num>5</item_img_num>
            <item_img_size>1024</item_img_size>
            <prop_img_num>5</prop_img_num>
            <prop_img_size>1024</prop_img_size>
            <auto_repost>unlimited</auto_repost>
            <promoted_type>authentication</promoted_type>
            <status>normal</status>
            <alipay_bind>bind</alipay_bind>
            <consumer_protection>true</consumer_protection>
            <vip_info>v1</vip_info>
            <magazine_subscribe>true</magazine_subscribe>
            <vertical_market>3C,shoes</vertical_market>
            <avatar>http://assets.taobaocdn.com/app/sns/img/default/avatar-120.png</avatar>
            <online_gaming>true</online_gaming>
            <liangpin>true</liangpin>
            <sign_food_seller_promise>true</sign_food_seller_promise>
            <has_shop>true</has_shop>
            <is_lightning_consignment>true</is_lightning_consignment>
            <has_sub_stock>true</has_sub_stock>
            <is_golden_seller>true</is_golden_seller>
            <is_tjb_seller>false</is_tjb_seller>
            <displaynick>displayNIck001</displaynick>
            <open_uid>adflajfaf</open_uid>
        </user>
    </user_seller_get_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isv.shop-not-exist:invalid-shop 没有可访问的店铺 该接口是商家使用接口,非商家店铺不能查询、访问。

    API工具

    如何获得此API

    FAQ

    返回
    顶部