文档中心 > API类目 > 店铺会员管理API

taobao.crm.members.search.privy (获取卖家会员(高级查询))

会员列表的高级查询,接口返回符合条件的会员列表.
注:建议获取09年以后的数据,09年之前的数据不是很完整

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
grade Number 可选 1
  • 默认值:-1
  • 会员等级
    relation_source Number 可选 1
  • 最大长度:32
  • 关系来源,1交易成功,2未成交,3卖家手动吸纳
    max_last_trade_time Date 可选 2000-01-01 00:00:00 最迟上次交易时间
    min_last_trade_time Date 可选 2000-01-01 00:00:00 最早上次交易时间(订单创建时间)
    min_trade_count Number 可选 2 最小交易量
    max_trade_count Number 可选 4 最大交易量
    group_id Number 可选 25354
  • 最大长度:19
  • 分组id
    current_page Number 必须 5 显示第几页的会员,如果输入的页码大于总共的页码数,例如总共10页,但是current_page的值为11,则返回空白页,最小页数为1.最大1000页
    page_size Number 可选 16 每页显示的会员数量,page_size的最大值不能超过100,最小值不能小于1
    min_trade_amount Price 可选 23.76 最小交易额,单位为元
    max_trade_amount Price 可选 23.76 最大交易额,单位为元
    ouid String 可选 123 ouid

    响应参数

    名称 类型 示例值 描述
    members CrmMember [] 根据一定条件查询的卖家会员
    • └ item_num
    • Number
    • 4
    • 购买的宝贝件数
    • └ item_close_count
    • Number
    • 2
    • 交易关闭的宝贝件数
    • └ close_trade_amount
    • String
    • 23.34
    • 交易关闭的金额
    • └ status
    • String
    • normal
    • 显示会员的状态,normal正常,blacklist黑名单
    • └ group_ids
    • String
    • 253764|2537648
    • 会员拥有的所有分组
    • └ relation_source
    • Number
    • 1
    • 关系来源,1交易成功,2未成交,3卖家主动吸纳
    • └ close_trade_count
    • Number
    • 2
    • 交易关闭的的笔数
    • └ last_trade_time
    • Date
    • 2000-01-01 00:00:00
    • 最后交易时间
    • └ biz_order_id
    • Number
    • 2635476788
    • 最后一次交易的订单号.注:该字段从2014.4.23之后不再返回.
    • └ city
    • String
    • 310020
    • 城市.请注意:从2014.4.23之后,省市将采用地区标准码,请通过物流API taobao.areas.get接口获取,参考:http://api.taobao.com/apidoc/api.htm?spm=0.0.0.0.nOOF9g&path=cid:7-apiId:59.API对于老的省市代码兼容会逐步下线.
    • └ ouid
    • String
    • 123
    • openuid
    • └ province
    • Number
    • 310000
    • 北京=1,天津=2,河北省=3,山西省=4,内蒙古自治区=5,辽宁省=6,吉林省=7,黑龙江省=8,上海=9,江苏省=10,浙江省=11,安徽省=12,福建省=13,江西省=14,山东省=15,河南省=16,湖北省=17,湖南省=18, 广东省=19,广西壮族自治区=20,海南省=21,重庆=22,四川省=23,贵州省=24,云南省=25,西藏自治区26,陕西省=27,甘肃省=28,青海省=29,宁夏回族自治区=30,新疆维吾尔自治区=31,台湾省=32,香港特别行政区=33,澳门特别行政区=34,海外=35.注:请注意:从2014.4.23之后,省市将采用地区标准码,请通过物流API taobao.areas.get接口获取,参考:http://api.taobao.com/apidoc/api.htm?spm=0.0.0.0.nOOF9g&path=cid:7-apiId:59.API对于老的省市代码兼容会逐步下线.
    • └ grade
    • Number
    • 1
    • 会员等级,0未非会员,其余对应等级名称取grade_name
    • └ trade_amount
    • String
    • 34.45
    • 交易成功的金额
    • └ trade_count
    • Number
    • 4
    • 交易成功笔数
    • └ avg_price
    • String
    • 23.54
    • 平均客单价.
    • └ grade_name
    • String
    • 普通会员
    • 等级名称
    total_result Number 1 记录的总条数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CrmMembersSearchPrivyRequest req = new CrmMembersSearchPrivyRequest();
    req.setGrade(1L);
    req.setRelationSource(1L);
    req.setMaxLastTradeTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setMinLastTradeTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setMinTradeCount(2L);
    req.setMaxTradeCount(4L);
    req.setGroupId(25354L);
    req.setCurrentPage(5L);
    req.setPageSize(16L);
    req.setMinTradeAmount("23.76");
    req.setMaxTradeAmount("23.76");
    req.setOuid("123");
    CrmMembersSearchPrivyResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <crm_members_search_privy_response>
        <members>
            <crm_member>
                <item_num>4</item_num>
                <item_close_count>2</item_close_count>
                <close_trade_amount>23.34</close_trade_amount>
                <status>normal</status>
                <group_ids>253764|2537648</group_ids>
                <relation_source>1</relation_source>
                <close_trade_count>2</close_trade_count>
                <last_trade_time>2000-01-01 00:00:00</last_trade_time>
                <biz_order_id>2635476788</biz_order_id>
                <city>310020</city>
                <ouid>123</ouid>
                <province>310000</province>
                <grade>1</grade>
                <trade_amount>34.45</trade_amount>
                <trade_count>4</trade_count>
                <avg_price>23.54</avg_price>
                <grade_name>普通会员</grade_name>
            </crm_member>
        </members>
        <total_result>1</total_result>
    </crm_members_search_privy_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.buyer-not-exist:buyer_nick 当前的会员不存在或者不是当前卖家的会员 检查buyer_nick是否正确
    isv.invalid-parameter:grade grade的取值不正确 grade的取值集合为[0,1,2,3,4,5,6]
    isv.parameters-mismatch:min_trade_amount-and-max_trade_amount 最小交易金额大于最大交易金额 最小交易金额不能大于最大交易金额
    isv.parameters-mismatch:min_trade_count-and-max_trade_count 最小交易次数大于最大交易次数 最小交易次数不能于最大交易次数
    isv.parameters-mismatch:min_last_trade_time-and-max_last_trade_time 最早最后交易时间大于最迟最后交易时间 最早最后交易时间不能大于最迟最后交易时间
    isv.invalid-parameter:relation_source 输入的客户来源不正确 relation_source的取值集合为[1,2,3]
    isv.invalid-parameter:province 输入的省份编号不正确 检查省份输入是否有效
    isv.parameters-mismatch:min_avg_price-and-max_avg_price 最小平均客单价大于最大平均客单价 最小平均客单价要小于最大平均客单价
    isv.parameters-mismatch:min_item_num-and-max_item_num 最小宝贝件数大于最大宝贝件数 最小宝贝件数不能大于最大宝贝件数
    isv.parameters-mismatch:min_close_trade_num-and-max_close_trade_num 最小交易关闭数大于最大交易关闭数 检查交易关闭笔数的区间,最小值不能超过最大值
    isv.invalid-parameter:order 输入的值不能作为排序字段 order字段的格式如:grade,其中排序字段 可以为tradeCount,tradeAmount,avgPrice,lastTradeTime。
    isp.crmtop-service-unavailable 当前服务不可用 请稍侯再试
    isv.invalid-permission 当前的登录权限不够 检查帐号权限
    isv.invalid-parameter:sort 输入的sort值不正确 sort的取值为[asc,desc]
    isp.service-unavailable 当前服务不可用 请联系ISP接口提供者
    isp.top-remote-unknown-error 当前服务不可用 请联系ISP接口提供者
    isv.seller-cannot-query 表示该商家不是常用商家,数据未准备好,暂不支持复杂条件查询。 请至少1天后再试

    API工具

    如何获得此API

    FAQ

    返回
    顶部