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

taobao.tbk.sc.rec.material (淘宝客-服务商-单品推荐)

服务商使用。支持入参推广者对应的“推广位”和官方提供的“物料id”以及商品ID,针对指定商品进行单品智能推荐,获取推荐商品的物料信息和推广者对应的推广链接,(需智能推荐请先前协议https://pub.alimama.com/fourth/protocol/common.htm?key=hangye_laxin)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 可选 20
  • 默认值:20
  • 页大小,默认20,1~100
    page_no Number 可选 1
  • 默认值:1
  • 第几页,默认:1
    adzone_id Number 必须 123 mm_xxx_xxx_xxx的第3段数字
    material_id Number 必须 123 官方提供的物料Id(详细物料id见:https://market.m.taobao.com/app/qn/toutiao-new/index-pc.html#/detail/10628875?_k=gpov9a)
    site_id Number 必须 111 mm_xxx_xxx_xxx的第2段数字
    item_id String 必须 33243 商品ID,用于相似商品推荐
    page_url String 可选 https://www.xxx.com 承接页URL
    external_type Number 可选 1 调用类型
    external_id String 可选 123 外部ID
    user_sid String 可选 123 备案ID
    profit_ratio String 可选 127 媒体营销比例,单位为分,127表示1.27%
    client_ip String 可选 127.0.0.1 客户端ip地址,部分场景需要

    响应参数

    名称 类型 示例值 描述
    result_list MapData [] resultList
    • └ item_basic_info
    • String
    • 商品基本信息
    • └ promotion_info
    • String
    • 商品的权益信息,例如优惠券、推广链接等
    • └ activity_info
    • String
    • 商品所属活动类信息,例如榜单等
    • └ publish_info
    • String
    • 商品的淘客推广信息
    • └ shop_info
    • String
    • 商品的店铺信息
    is_default String false 推荐信息-是否抄底

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TbkScRecMaterialRequest req = new TbkScRecMaterialRequest();
    req.setPageSize(20L);
    req.setPageNo(1L);
    req.setAdzoneId(123L);
    req.setMaterialId(123L);
    req.setSiteId(111L);
    req.setItemId("33243");
    req.setPageUrl("https://www.xxx.com");
    req.setExternalType(1L);
    req.setExternalId("123");
    req.setUserSid("123");
    req.setProfitRatio("127");
    req.setClientIp("127.0.0.1");
    TbkScRecMaterialResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tbk_sc_rec_material_response>
        <result_list>
            <map_data>
            </map_data>
        </result_list>
        <is_default>false</is_default>
    </tbk_sc_rec_material_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

    返回
    顶部