文档中心 > API类目 > 海外-淘宝客API

taobao.ovs.tbk.item.info.upgrade.get (海外淘宝客-公用-淘宝客商品详情查询升级版(简易版))

海外淘宝客-公用-淘宝客商品详情查询升级版(简易版)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_ids String 必须 3232 商品ID串,用,分割,最大20个
ip String 可选 11.22.33.43 ip地址,影响邮费获取,如果不传或者传入不准确,邮费无法精准提供

响应参数

名称 类型 示例值 描述
results TbkItemDetail [] 淘宝客商品
  • └ item_id
  • String
  • 123
  • 商品ID
  • publish_info
  • PublishInfo
  • 淘客推广信息
  • └ income_rate
  • String
  • 15.5
  • 商品信息-收入比率(商品佣金比率+补贴比率)。15.5表示15.5%
  • topn_info
  • TopnInfo
  • 前N件佣金信息-前N件佣金生效或预热时透出以下字段
  • └ topn_quantity
  • Number
  • 3000
  • 前N件剩余库存
  • └ topn_total_count
  • Number
  • 3000
  • 前N件初始总库存
  • └ topn_rate
  • String
  • 1937297392332
  • 前N件佣金结束时间
  • └ topn_end_time
  • String
  • 1937297392332
  • 前N件佣金开始时间
  • └ topn_start_time
  • String
  • 30
  • 前N件佣金率
  • price_promotion_info
  • PromotionInfoMapData
  • 价格促销信息
  • └ reserve_price
  • String
  • 102.00
  • 商品一口价格
  • └ predict_rounding_up_price
  • String
  • 56.1
  • 促销信息-预估凑单价(元)。预估凑单叠加优惠后的商品单价
  • promotion_tag_list
  • PromotionTagMapData []
  • 标签信息列表
  • └ tag_name
  • String
  • 88VIP
  • 标签名称,如“88VIP”、“花呗免息”、“猫超买返”、“是否包邮”
  • activity_tag_list
  • ActivityTagMapData []
  • 货品展示标识列表
  • └ tag_name
  • String
  • 淘宝好价节
  • 货品展示标识,展示在商品标题前的商品活动标
  • └ final_promotion_price
  • String
  • 69.9
  • 促销信息-预估到手价(元)。若属于预售商品,付定金时间内,预估到手价=预售尾款预估到手价
  • └ predict_rounding_up_price_desc
  • String
  • 需买1件
  • 促销信息-凑单价说明,描述凑单价的实现说明。如 “可凑单”或“需买X件”
  • final_promotion_path_list
  • FinalPromotionPathMapData []
  • 优惠促销列表
  • └ promotion_title
  • String
  • 商品券
  • 优惠名称,如“商品券”、“跨店满减”、“单品直降”等
  • └ promotion_start_time
  • String
  • 2019-11-10 21:59:59
  • 优惠开始时间
  • └ promotion_desc
  • String
  • 满7999减1300
  • 优惠利益点文案,如“1件7.92折”、“每200减20”等
  • └ promotion_end_time
  • String
  • 2019-11-10 21:59:59
  • 优惠结束时间
  • └ promotion_fee
  • String
  • 1300
  • 优惠金额(元)
  • └ promotion_id
  • String
  • XX
  • 优惠ID
  • more_promotion_list
  • MorePromotionMapData []
  • 更多活动优惠
  • └ promotion_title
  • String
  • 满件折
  • 预热优惠名称,如“商品券”、“跨店满减”、“单品直降”等
  • └ promotion_start_time
  • String
  • 1661222400000
  • 优惠开始时间
  • └ promotion_desc
  • String
  • 2件9折
  • 预热优惠利益点文案,如“1件7.92折”、“每200减20”等
  • └ promotion_end_time
  • String
  • 1661222400000
  • 优惠结束时间
  • └ promotion_id
  • String
  • XX
  • 优惠ID
  • └ zk_final_price
  • String
  • 88.00
  • 折扣价(元) 若属于预售商品,付定金时间内,折扣价=预售价
  • └ input_item_iid
  • String
  • qeqscd1231-uqwenqe
  • 输入的(新)商品ID
  • item_basic_info
  • BasicMapData
  • 商品基本信息
  • └ white_image
  • String
  • https://img.alicdn.com/bao/uploaded/TB1De0xk4n1gK0jSZKPXXXvUXXa.png
  • 商品信息-商品白底图
  • └ free_shipment
  • Boolean
  • true
  • 商品信息-是否包邮
  • └ superior_brand
  • String
  • 1
  • 是否品牌精选,0不是,1是
  • └ short_title
  • String
  • 巴布豆菠萝超薄干爽拉拉裤xl60+6
  • 商品信息-商品短标题
  • └ title
  • String
  • 连衣裙
  • 商品标题
  • └ category_name
  • String
  • 情趣内衣
  • 叶子类目名称
  • └ small_images
  • String []
  • 商品小图列表
  • └ i_rfd_rate
  • Boolean
  • true
  • 退款率是否低于行业均值
  • └ shop_dsr
  • Number
  • 23
  • 店铺dsr 评分
  • └ material_lib_type
  • String
  • 1
  • 商品库类型,支持多库类型输出,以英文逗号分隔“,”分隔,1:营销商品主推库,2. 内容商品库,如果值为空则不属于1,2这两种商品类型
  • └ taobao_desc_url
  • String
  • https://h5.m.taobao.com/app/detail/desc.html?_isH5Des=true#!id=2332&type=0&f=sdsdsd
  • H5宝贝详情
  • └ brand_name
  • String
  • 淘宝心选
  • 商品信息-品牌名称
  • └ tmall_desc_url
  • String
  • ttps://mdetail.tmall.com/templates/pages/desc?id=5323
  • pc宝贝详情
  • └ h_good_rate
  • Boolean
  • true
  • 好评率是否高于行业均值
  • └ level_one_category_name
  • String
  • 女装
  • 一级类目名称
  • └ h_pay_rate30
  • Boolean
  • true
  • 成交转化是否高于行业均值
  • └ pict_url
  • String
  • http://gi4.md.alicdn.com/bao/uploaded/i4/xxx.jpg
  • 商品主图
  • └ is_prepay
  • Boolean
  • true
  • 是否加入消费者保障
  • └ volume
  • String
  • 1
  • 30天销量;数据统计截止昨日非实时更新
  • └ provcity
  • String
  • 杭州
  • 商品所在地
  • └ ratesum
  • Number
  • 13
  • 卖家等级
  • └ shop_title
  • String
  • xx旗舰店
  • 商品信息-店铺名称
  • └ user_type
  • Number
  • 1
  • 卖家类型,0表示集市,1表示商城,3表示特价版
  • └ item_url
  • String
  • http://detail.m.tmall.com/item.htm?id=xxx
  • 商品链接
  • └ annual_vol
  • String
  • 1万+
  • 年销量
  • presale_info
  • PresaleInfo
  • 预售信息
  • └ presale_discount_fee_text
  • String
  • 付定金立减5元
  • 预售商品-优惠信息
  • └ presale_end_time
  • Number
  • 1567440000000
  • 预售商品-付定金结束时间(毫秒)
  • └ presale_deposit
  • String
  • 100
  • 预售商品-定金(元)
  • └ presale_tail_end_time
  • Number
  • 1567440000000
  • 预售商品-付尾款结束时间(毫秒)
  • └ presale_start_time
  • Number
  • 1567440000000
  • 预售商品-付定金开始时间(毫秒)
  • └ presale_tail_start_time
  • Number
  • 1567440000000
  • 预售商品-付尾款开始时间(毫秒)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OvsTbkItemInfoUpgradeGetRequest req = new OvsTbkItemInfoUpgradeGetRequest();
req.setItemIds("3232");
req.setIp("11.22.33.43");
OvsTbkItemInfoUpgradeGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ovs_tbk_item_info_upgrade_get_response>
    <results>
        <tbk_item_detail>
            <item_id>123</item_id>
            <publish_info>
                <income_rate>15.5</income_rate>
                <topn_info>
                    <topn_quantity>3000</topn_quantity>
                    <topn_total_count>3000</topn_total_count>
                    <topn_rate>1937297392332</topn_rate>
                    <topn_end_time>1937297392332</topn_end_time>
                    <topn_start_time>30</topn_start_time>
                </topn_info>
            </publish_info>
            <price_promotion_info>
                <reserve_price>102.00</reserve_price>
                <predict_rounding_up_price>56.1</predict_rounding_up_price>
                <promotion_tag_list>
                    <promotion_tag_map_data>
                        <tag_name>88VIP</tag_name>
                    </promotion_tag_map_data>
                </promotion_tag_list>
                <activity_tag_list>
                    <activity_tag_map_data>
                        <tag_name>淘宝好价节</tag_name>
                    </activity_tag_map_data>
                </activity_tag_list>
                <final_promotion_price>69.9</final_promotion_price>
                <predict_rounding_up_price_desc>需买1件</predict_rounding_up_price_desc>
                <final_promotion_path_list>
                    <final_promotion_path_map_data>
                        <promotion_title>商品券</promotion_title>
                        <promotion_start_time>2019-11-10 21:59:59</promotion_start_time>
                        <promotion_desc>满7999减1300</promotion_desc>
                        <promotion_end_time>2019-11-10 21:59:59</promotion_end_time>
                        <promotion_fee>1300</promotion_fee>
                        <promotion_id>XX</promotion_id>
                    </final_promotion_path_map_data>
                </final_promotion_path_list>
                <more_promotion_list>
                    <more_promotion_map_data>
                        <promotion_title>满件折</promotion_title>
                        <promotion_start_time>1661222400000</promotion_start_time>
                        <promotion_desc>2件9折</promotion_desc>
                        <promotion_end_time>1661222400000</promotion_end_time>
                        <promotion_id>XX</promotion_id>
                    </more_promotion_map_data>
                </more_promotion_list>
                <zk_final_price>88.00</zk_final_price>
            </price_promotion_info>
            <input_item_iid>qeqscd1231-uqwenqe</input_item_iid>
            <item_basic_info>
                <white_image>https://img.alicdn.com/bao/uploaded/TB1De0xk4n1gK0jSZKPXXXvUXXa.png</white_image>
                <free_shipment>true</free_shipment>
                <superior_brand>1</superior_brand>
                <short_title>巴布豆菠萝超薄干爽拉拉裤xl60+6</short_title>
                <title>连衣裙</title>
                <category_name>情趣内衣</category_name>
                <i_rfd_rate>true</i_rfd_rate>
                <shop_dsr>23</shop_dsr>
                <material_lib_type>1</material_lib_type>
                <taobao_desc_url>https://h5.m.taobao.com/app/detail/desc.html?_isH5Des=true#!id=2332&amp;type=0&amp;f=sdsdsd</taobao_desc_url>
                <brand_name>淘宝心选</brand_name>
                <tmall_desc_url>ttps://mdetail.tmall.com/templates/pages/desc?id=5323</tmall_desc_url>
                <h_good_rate>true</h_good_rate>
                <level_one_category_name>女装</level_one_category_name>
                <h_pay_rate30>true</h_pay_rate30>
                <pict_url>http://gi4.md.alicdn.com/bao/uploaded/i4/xxx.jpg</pict_url>
                <is_prepay>true</is_prepay>
                <volume>1</volume>
                <provcity>杭州</provcity>
                <ratesum>13</ratesum>
                <shop_title>xx旗舰店</shop_title>
                <user_type>1</user_type>
                <item_url>http://detail.m.tmall.com/item.htm?id=xxx</item_url>
                <annual_vol>1万+</annual_vol>
            </item_basic_info>
            <presale_info>
                <presale_discount_fee_text>付定金立减5元</presale_discount_fee_text>
                <presale_end_time>1567440000000</presale_end_time>
                <presale_deposit>100</presale_deposit>
                <presale_tail_end_time>1567440000000</presale_tail_end_time>
                <presale_start_time>1567440000000</presale_start_time>
                <presale_tail_start_time>1567440000000</presale_tail_start_time>
            </presale_info>
        </tbk_item_detail>
    </results>
</ovs_tbk_item_info_upgrade_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

返回
顶部