taobao.yanxuan.items.get (直播严选商品列表查询)

直播严选商品列表查询。本接口需要使用机构授权发起调用,发起调用前请联系淘宝直播严选官方获取授权许可。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_no Number 可选 1 页码
page_size Number 可选 1 每页条数,最大不可超过10
open_anchor_id String 必须 123456 主播openID
item_id Number 可选 123456 要查询商品id

响应参数

名称 类型 示例值 描述
total_results Number 998 数据总数
data ItemList [] 响应结果
  • └ query_time
  • String
  • 2022-12-10 00:00:00
  • 日期:查询的当下时刻
  • └ item_id
  • Number
  • 123456
  • 商品id
  • └ status
  • String
  • 0-下架 1-正常 -1-删除
  • 商品上下架状态
  • └ picture
  • String
  • www.xxxx.com/pic
  • 商品主图详情主图
  • └ title
  • String
  • 保时捷
  • 商品标题
  • └ live_price
  • String
  • 9.8
  • 招商时商家填写的直播价,比如:399元/瓶、9.88等
  • └ bc_type
  • String
  • B
  • 商品来源 B店 or C店
  • └ shop_name
  • String
  • xx官方旗舰店
  • 店铺名称
  • └ brand
  • String
  • 某知名品牌
  • 品牌名称
  • └ item_tcp_link
  • String
  • xxx
  • 商业化链接
  • └ ratio
  • String
  • 100
  • 佣金比例,单位万分之
  • └ ratio_start_time
  • String
  • 2022-12-10 12:00:00
  • 佣金开始时间
  • └ ratio_end_time
  • String
  • 2022-12-20 10:00:00
  • 佣金开始时间
  • skus
  • Sku []
  • sku列表
  • └ price
  • String
  • 5.00
  • 商品价格
  • └ properties
  • String
  • 1243:1215;5626:5125
  • 销售属性
  • └ properties_name
  • String
  • 20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1
  • 销售属性中文
  • └ quantity
  • Number
  • 300
  • 属于这个sku的商品的数量
  • └ sku_id
  • Number
  • 32343400
  • sku的id
  • categories
  • ItemCategory []
  • 商品类目树
  • └ cid
  • Number
  • 123
  • 类目id
  • └ name
  • String
  • 美容护肤/美体/精油
  • 类目名称
  • └ is_parent
  • Boolean
  • true
  • 该类目是否为父类目(即:该类目是否还有子类目)
  • └ parent_cid
  • Number
  • 0
  • 父类目ID=0时,代表的是一级的类目

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
YanxuanItemsGetRequest req = new YanxuanItemsGetRequest();
req.setPageNo(1L);
req.setPageSize(1L);
req.setOpenAnchorId("123456");
req.setItemId(123456L);
YanxuanItemsGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<yanxuan_items_get_response>
    <total_results>998</total_results>
    <data>
        <item_list>
            <query_time>2022-12-10 00:00:00</query_time>
            <item_id>123456</item_id>
            <status>0-下架 1-正常 -1-删除</status>
            <picture>www.xxxx.com/pic</picture>
            <title>保时捷</title>
            <live_price>9.8</live_price>
            <bc_type>B</bc_type>
            <shop_name>xx官方旗舰店</shop_name>
            <brand>某知名品牌</brand>
            <item_tcp_link>xxx</item_tcp_link>
            <ratio>100</ratio>
            <ratio_start_time>2022-12-10 12:00:00</ratio_start_time>
            <ratio_end_time>2022-12-20 10:00:00</ratio_end_time>
            <skus>
                <sku>
                    <price>5.00</price>
                    <properties>1243:1215;5626:5125</properties>
                    <properties_name>20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1</properties_name>
                    <quantity>300</quantity>
                    <sku_id>32343400</sku_id>
                </sku>
            </skus>
            <categories>
                <item_category>
                    <cid>123</cid>
                    <name>美容护肤/美体/精油</name>
                    <is_parent>true</is_parent>
                    <parent_cid>0</parent_cid>
                </item_category>
            </categories>
        </item_list>
    </data>
</yanxuan_items_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

返回
顶部