文档中心 > API类目 > 淘宝客API

taobao.tbk.content.recommend.material.get (淘宝客-推广者-图文智能识别消费者端推荐物料查询)

消费者端推荐物料输出接口。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 可选 20
  • 默认值:20
  • 页大小,默认20,1~100
    page_num Number 可选 1
  • 默认值:1
  • 第几页,默认:1
    adzone_id Number 必须 123 mm_xxx_xxx_xxx的第三位
    content_id String 必须 uc_xxxxx 媒体内容id
    sub_pid String 必须 mm_123_456_789 达人subPid

    响应参数

    名称 类型 示例值 描述
    result_list MapData [] resultList
    • └ coupon_amount
    • Number
    • 40
    • 优惠券信息-优惠券面额。如:满299元减20元
    • └ shop_title
    • String
    • 魔黛娅内衣旗舰店
    • 店铺信息-店铺名称
    • └ coupon_start_fee
    • String
    • 69
    • 优惠券信息-优惠券起用门槛,满X元可用。如:满299元减20元
    • └ coupon_total_count
    • Number
    • 30000
    • 优惠券信息-优惠券总量
    • └ user_type
    • Number
    • 1
    • 店铺信息-卖家类型,0表示集市,1表示商城
    • └ zk_final_price
    • String
    • 79.9
    • 商品信息-商品折扣价格
    • └ coupon_start_time
    • String
    • 2017-10-29
    • 优惠券信息-优惠券开始时间
    • └ title
    • String
    • 毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款
    • 商品信息-商品标题
    • └ volume
    • Number
    • 3837
    • 商品信息-30天销量
    • └ coupon_end_time
    • String
    • 2017-11-02
    • 优惠券信息-优惠券结束时间
    • └ coupon_share_url
    • String
    • //uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0
    • 券二合一链接
    • └ pict_url
    • String
    • //img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg
    • 商品信息-商品主图
    • └ click_url
    • String
    • //s.click.taobao.com/t?e=m%3D2%26s%3DuHk3LsWO7NRw4vFB6t2Z2ueEDrYVVa64LKpWJ%2Bin0XLjf2vlNIV67hKx4R7cy6GL2Y%2Bdtp35Zpq%2Fr1EKiEQwcsUNmoA4ubwK0p%2BZKPXjvjsNBTdchAjpbDIrMad9IKIuzw0S7DwV9C24%2FApvI96NZlS1tdX9DLjzjHH9b9takmD%2BC6IBjof6lq%2BA9WMYINZ7YXh4NEyNHJkPWp8sFi3N5j7lCjCC8ck8
    • 链接-宝贝推广链接
    • └ orig_price
    • String
    • 20
    • 原价
    • └ nick
    • String
    • 秉迪数码专营店
    • 店铺信息-卖家昵称
    • └ source_from
    • String
    • http://XXX
    • 商品推荐图片来源
    • └ encrypt_item_id
    • String
    • xxxx
    • 加密后的itemId
    total_results Number 30 通过审核的推荐商品总数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TbkContentRecommendMaterialGetRequest req = new TbkContentRecommendMaterialGetRequest();
    req.setPageSize(20L);
    req.setPageNum(1L);
    req.setAdzoneId(123L);
    req.setContentId("uc_xxxxx");
    req.setSubPid("mm_123_456_789");
    TbkContentRecommendMaterialGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tbk_content_recommend_material_get_response>
        <result_list>
            <map_data>
                <coupon_amount>40</coupon_amount>
                <shop_title>魔黛娅内衣旗舰店</shop_title>
                <coupon_start_fee>69</coupon_start_fee>
                <coupon_total_count>30000</coupon_total_count>
                <user_type>1</user_type>
                <zk_final_price>79.9</zk_final_price>
                <coupon_start_time>2017-10-29</coupon_start_time>
                <title>毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款</title>
                <volume>3837</volume>
                <coupon_end_time>2017-11-02</coupon_end_time>
                <coupon_share_url>//uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0</coupon_share_url>
                <pict_url>//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</pict_url>
                <click_url>//s.click.taobao.com/t?e=m%3D2%26s%3DuHk3LsWO7NRw4vFB6t2Z2ueEDrYVVa64LKpWJ%2Bin0XLjf2vlNIV67hKx4R7cy6GL2Y%2Bdtp35Zpq%2Fr1EKiEQwcsUNmoA4ubwK0p%2BZKPXjvjsNBTdchAjpbDIrMad9IKIuzw0S7DwV9C24%2FApvI96NZlS1tdX9DLjzjHH9b9takmD%2BC6IBjof6lq%2BA9WMYINZ7YXh4NEyNHJkPWp8sFi3N5j7lCjCC8ck8</click_url>
                <orig_price>20</orig_price>
                <nick>秉迪数码专营店</nick>
                <source_from>http://XXX</source_from>
                <encrypt_item_id>xxxx</encrypt_item_id>
            </map_data>
        </result_list>
        <total_results>30</total_results>
    </tbk_content_recommend_material_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

    返回
    顶部