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

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

海外淘宝客-公用-淘宝客商品详情查询升级版(简版)-V3,用于海外淘客商品信息查询,可以通过逗号分隔商品id,来批量查询商品信息;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_ids String 必须 3232 商品ID串,用,分割,最大20个
ip String 可选 11.22.33.43 ip地址,影响邮费获取,如果不传或者传入不准确,邮费无法精准提供
language String 可选 zh_CN
  • 默认值:zh_CN
  • 语言:zh_CN(中文);en_US(英文)
    site String 可选 TW
  • 默认值:GLOBAL
  • 站点标识:TW(台湾);HK(香港);MY(马来);SG(新加坡);AU(澳大利亚);CA(加拿大);MO(澳门);GLOBAL(全球),GLOBAL(全球)不存在禁限售的逻辑,若填写指定的站点,会校验禁限售的逻辑

    响应参数

    名称 类型 示例值 描述
    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");
    req.setLanguage("zh_CN");
    req.setSite("TW");
    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

    返回
    顶部