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

taobao.tbk.sc.content.material (淘宝客-服务商-爆料分享物料获取)

爆料分享物料获取-服务商

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
adzone_id Number 必须 12345678 mm_xxx_xxx_xxx的第3段数字
site_id Number 必须 22 mm_xxx_xxx_xxx的第2段数字
page_num Number 可选 2 第几页,默认:1,第一页为1
page_size Number 可选 20 页大小,默认20,1~100
start_time String 可选 2015-01-01 12:00:00 爆料素材开始时间,如果没有入参时间,查询内容为从爆料上传时间开始的全部爆料商品信息,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8
end_time String 可选 2015-02-01 12:00:00 爆料素材结束时间,如果没有入参时间,查询内容为从爆料上传时间开始的全部爆料商品信息,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8
item_ids String 可选 qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9,5K5QvIxt49NADH0AwcMtV-83PjG2AU0bba4QyPFqd 商品ID,多值使用英文逗号拼接
scene_id String 可选 1 支持入参场景id:1和3
price_floor String 可选 9.9 爆料价格下限
price_ceiling String 可选 19.9 爆料价格上限
use_scene String 可选 3,4,5,6,7 3:优惠导购-淘宝联盟-社群;4:优惠导购-淘宝联盟-朋友圈 ;5:优惠导购-淘宝联盟-APP ;6:优惠导购-淘宝联盟;7:推广素材-淘宝联盟。多个时使用英文逗号拼接

响应参数

名称 类型 示例值 描述
result_list MapData [] resultList
  • └ item_id
  • String
  • eNyJVYSzCQg0zBF6WgIzt0-Y6qWKqsd2eY3qozHX
  • 主商品ID
  • └ material_price
  • String
  • 46.78
  • 爆料价,数字,最多为2位小数
  • └ material_desc_list
  • String []
  • 素材文字描述列表,包含爆料导购文案和推广基本文案,推广文案类型详见社群基本素材参数
  • └ material_pic_list
  • String []
  • 素材图片描述列表,包含爆料导购图片和推广图片,推广图片类型详见社群基本素材参数
  • └ material_author
  • String
  • 每日好物发现官
  • 素材发布者
  • └ material_tag
  • String
  • 母婴好物
  • 素材标签
  • └ shop_title
  • String
  • 苹果官方旗舰店
  • 店铺名称
  • └ month_sell_count
  • String
  • 100
  • 月销量
  • └ material_time
  • String
  • 2015-01-01 12:00:00
  • 爆料素材时间,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8
  • └ input_item_id
  • String
  • qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9
  • 入参的商品ID,入参指定商品ID时关联入参与返回结果
  • └ material_id
  • String
  • 123
  • 素材唯一ID
  • └ material_type
  • String
  • 1
  • 素材类型,1:商品;2:活动
  • └ pre_commission_rate
  • String
  • 10.01
  • 预告佣金率
  • └ content_type
  • String
  • 1
  • 内容类型,1:实时单 2:预告单
  • └ use_scene
  • String
  • 3,5
  • 使用场景:3:优惠导购-淘宝联盟-社群;4:优惠导购-淘宝联盟-朋友圈 ;5:优惠导购-淘宝联盟-APP ;6:优惠导购-淘宝联盟;7:推广素材-淘宝联盟
  • └ modified_time
  • String
  • 2015-02-01 12:00:00
  • 素材修改时间
  • └ coupon_url
  • String []
  • https://uland.taobao.com/quan/detail?sellerId=2216060743&activityId=8dfac9d172c949dea09b930f3946c92f
  • 券链接
  • └ discount_need_item_count
  • Number
  • 3
  • 优惠价格需购件数
  • └ add_on_item_ids
  • String []
  • 凑单商品id
  • 凑单商品id
  • └ price_start_time
  • String
  • 2015-01-01 12:00:00
  • 爆料价开始时间
  • └ price_end_time
  • String
  • 2015-02-01 12:00:00
  • 爆料价结束时间
  • └ preview_pic_list
  • String []
  • 预览图
  • └ title
  • String
  • 立白洗衣液9.9元500ml
  • 爆料素材标题
  • └ origin_time
  • String
  • 2015-01-01 12:00:00
  • 原作者发布时间
  • └ professional_tag_list
  • String []
  • 官方ip标签,0-88vip 1-淘金币 2-百亿补贴 3-天猫超市
  • └ price_tag_list
  • String []
  • 价格力标签
  • └ publisher_avatar
  • String
  • https://content.material.alimama.com/f02832c4-19fc-4500-83bf-b022a77ba58b.jpg
  • 原作者头像
  • └ publisher_nickname
  • String
  • 张三
  • 原作者昵称
  • └ selling_point
  • String
  • 除菌消毒,清洁力超强
  • 商品卖点
  • └ price_structure
  • String
  • 买两件打5折
  • 价格实现方式
  • └ content_tag
  • String []
  • 内容标签
  • └ promotion_infos
  • String []
  • 官方立减10% 直降10元
  • 优惠信息描述
  • └ recommend_reason
  • String
  • 全网爆款,大牌保障,近x天最低价
  • 推广推荐理由
  • └ group_basic_material
  • String
  • /
  • 社群基本素材
  • group_selected_material
  • GroupSelectedMaterial []
  • 社群精推素材(包含文字和图片,图文混排)
  • └ type
  • String
  • 3002
  • 社群精选素材类型,3002:图片;3004:文本
  • └ content
  • String
  • /
  • 社群精选素材内容
  • └ seg_type
  • String
  • 1
  • 社群精选素材细分类型,图片类型:1:实拍图;2:订单图;3:营销图;4:白底图;5:其他;文本类型:1:综合;2:商品卖点;3:营销话术;4:社群话术;5:优惠信息;6:下单链接;7:其他
  • └ generate_from_mgc
  • Number
  • 1
  • 是否mgc生成,0:否;1:有
total_count Number 20 符合筛选条件的素材总数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkScContentMaterialRequest req = new TbkScContentMaterialRequest();
req.setAdzoneId(12345678L);
req.setSiteId(22L);
req.setPageNum(2L);
req.setPageSize(20L);
req.setStartTime("2015-01-01 12:00:00");
req.setEndTime("2015-02-01 12:00:00");
req.setItemIds("qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9,5K5QvIxt49NADH0AwcMtV-83PjG2AU0bba4QyPFqd");
req.setSceneId("1");
req.setPriceFloor("9.9");
req.setPriceCeiling("19.9");
req.setUseScene("3,4,5,6,7");
TbkScContentMaterialResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_sc_content_material_response>
    <result_list>
        <map_data>
            <item_id>eNyJVYSzCQg0zBF6WgIzt0-Y6qWKqsd2eY3qozHX</item_id>
            <material_price>46.78</material_price>
            <material_author>每日好物发现官</material_author>
            <material_tag>母婴好物</material_tag>
            <shop_title>苹果官方旗舰店</shop_title>
            <month_sell_count>100</month_sell_count>
            <material_time>2015-01-01 12:00:00</material_time>
            <input_item_id>qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9</input_item_id>
            <material_id>123</material_id>
            <material_type>1</material_type>
            <pre_commission_rate>10.01</pre_commission_rate>
            <content_type>1</content_type>
            <use_scene>3,5</use_scene>
            <modified_time>2015-02-01 12:00:00</modified_time>
            <coupon_url>
                <string>https://uland.taobao.com/quan/detail?sellerId=2216060743&amp;activityId=8dfac9d172c949dea09b930f3946c92f</string>
            </coupon_url>
            <discount_need_item_count>3</discount_need_item_count>
            <add_on_item_ids>
                <string>凑单商品id</string>
            </add_on_item_ids>
            <price_start_time>2015-01-01 12:00:00</price_start_time>
            <price_end_time>2015-02-01 12:00:00</price_end_time>
            <title>立白洗衣液9.9元500ml</title>
            <origin_time>2015-01-01 12:00:00</origin_time>
            <publisher_avatar>https://content.material.alimama.com/f02832c4-19fc-4500-83bf-b022a77ba58b.jpg</publisher_avatar>
            <publisher_nickname>张三</publisher_nickname>
            <selling_point>除菌消毒,清洁力超强</selling_point>
            <price_structure>买两件打5折</price_structure>
            <promotion_infos>
                <string>官方立减10% 直降10元</string>
            </promotion_infos>
            <recommend_reason>全网爆款,大牌保障,近x天最低价</recommend_reason>
            <group_basic_material>/</group_basic_material>
            <group_selected_material>
                <group_selected_material>
                    <type>3002</type>
                    <content>/</content>
                    <seg_type>1</seg_type>
                </group_selected_material>
            </group_selected_material>
            <generate_from_mgc>1</generate_from_mgc>
        </map_data>
    </result_list>
    <total_count>20</total_count>
</tbk_sc_content_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

返回
顶部