taobao.mcn.shop.traderates.get (商品评价)

商家授权; 搜索评价信息,只能获取距今180天内的评价记录(只支持查询卖家给出或得到的评价)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_no Number 可选 1 页码。取值范围:大于零的整数最大限制为200; 默认值:1
page_size Number 可选 100
  • 默认值:40
  • 每页获取条数。默认值40,最小值1,最大值150。
    start_date Date 必须 2022-01-01 00:00:00 评价开始时间。6个月内, 如果只输入开始时间,那么能返回开始时间之后的评价数据。
    end_date Date 必须 2023-01-02 00:00:00 评价结束时间。6个月内, 如果只输入结束时间,那么全部返回所有评价数据。
    use_has_next Boolean 可选 true
  • 默认值:false
  • 是否启用has_next的分页方式,如果指定true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取评价信息,效率在原有的基础上有80%的提升。
    num_iid Number 必须 1234 商品的数字ID

    响应参数

    名称 类型 示例值 描述
    total_results Number 50 搜索到的评价总数。相同的查询时间段条件下,最大只能获取总共1500条评价记录。所以当评价大于等于1500时 ISV可以通过start_date及end_date来进行拆分,以保证可以查询到全部数据
    has_next Boolean true 当使用use_has_next时返回信息,如果还有下一页则返回true
    trade_rates Results [] {} 评价列表。返回的TradeRate包含的具体信息为入参fields请求的字段信息
    • └ created
    • Date
    • 2010-01-01 13:30:05
    • 评价创建时间,格式:yyyy-MM-dd HH:mm:ss
    • └ item_title
    • String
    • cdma冲值卡
    • 商品标题
    • └ item_price
    • String
    • 200.07
    • 商品价格,精确到2位小数;单位:元.如:200.07,表示:200元7分
    • └ content
    • String
    • 很快、很好
    • 评价内容,最大长度:500个汉字
    • └ num_iid
    • Number
    • 1500006394531
    • 商品的数字ID
    • └ logistics_service_score
    • Number
    • 4
    • 物流服务评分

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    McnShopTraderatesGetRequest req = new McnShopTraderatesGetRequest();
    req.setPageNo(1L);
    req.setPageSize(100L);
    req.setStartDate(StringUtils.parseDateTime("2022-01-01 00:00:00"));
    req.setEndDate(StringUtils.parseDateTime("2023-01-02 00:00:00"));
    req.setUseHasNext(true);
    req.setNumIid(1234L);
    McnShopTraderatesGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <mcn_shop_traderates_get_response>
        <total_results>50</total_results>
        <has_next>true</has_next>
        <trade_rates>
            <results>
                <created>2010-01-01 13:30:05</created>
                <item_title>cdma冲值卡</item_title>
                <item_price>200.07</item_price>
                <content>很快、很好</content>
                <num_iid>1500006394531</num_iid>
                <logistics_service_score>4</logistics_service_score>
            </results>
        </trade_rates>
    </mcn_shop_traderates_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部