文档中心 > API类目 > 天猫奢品独立市场

tmall.luxury.stage.item.query (天猫奢品独立市场商品列表查询)

天猫奢品独立市场商品列表查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
modify_date_end Date 可选 2021-12-31 12:33:33 查询更新时间在此时间段之前的商品 需与modify_time_end成对使用
item_ids Number 可选 一组天猫商品ID
outer_ids String 可选 123,234 一组商家商品编码
title String 可选 戒指 商品标题,支持模糊查询
item_id Number 可选 123456 天猫商品ID
modify_date_begin Date 可选 2021-12-30 12:33:33 查询更新时间在此时间段之后的商品 需与modify_time_begin成对使用
outer_id String 可选 52340 商家商品编码
page PageDTO 可选 分页请求参数
  • └ page_size
  • Number
  • 可选
  • 20
  • 20 每页条数,最大不超过100,默认20
  • └ current_page
  • Number
  • 可选
  • 1
  • 当前页,默认1
status String 可选 normal normal非删除状态的所有商品 on_sale 在售的商品 on_warehouse 仓库中的商品 is_deleted 已删除的商品
is_presale Number 可选 1 预售商品查询:0查询非预售商品,1查询预售商品

响应参数

名称 类型 示例值 描述
items ItemQueryResponse [] 商品列表
  • └ seller_id
  • Number
  • 1231455567
  • 天猫卖家ID
  • └ item_id
  • Number
  • 1235868786
  • 天猫商品ID
  • └ title
  • String
  • 这是一个商品
  • 商品标题
  • └ main_pic_url
  • String
  • 商品主图
  • 主图URL
  • └ category_id
  • Number
  • 121448028
  • 叶子类目ID
  • └ price
  • Price
  • 123.56
  • 商品价格
  • └ quantity
  • Number
  • 12
  • 商品库存
  • └ with_holding_quantity
  • Number
  • 2
  • 预占库存
  • └ outer_id
  • String
  • 233858
  • 商家商品编码
  • └ sold_quantity
  • Number
  • 34
  • 累计销量
  • └ create_time
  • Date
  • 2021-12-31 12:30:30
  • 创建时间
  • └ modify_time
  • Date
  • 2021-12-31 12:30:30
  • 修改时间
  • └ starts_time
  • Date
  • 2021-12-31 12:30:30
  • 上架时间
  • └ status
  • Number
  • 0
  • 商品状态
  • └ is_presale
  • Number
  • 1
  • 是否预售商品:0否,1是
page PageDTO 分页结果
  • └ total_page
  • Number
  • 1
  • 总页数
  • └ page_size
  • Number
  • 20
  • 每页数据条数
  • └ total_count
  • Number
  • 19
  • 总数据条数
  • └ current_page
  • Number
  • 1
  • 当前页

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallLuxuryStageItemQueryRequest req = new TmallLuxuryStageItemQueryRequest();
req.setModifyDateEnd(StringUtils.parseDateTime("2021-12-31 12:33:33"));
req.setItemIds(L);
req.setOuterIds("123,234");
req.setTitle("戒指");
req.setItemId(123456L);
req.setModifyDateBegin(StringUtils.parseDateTime("2021-12-30 12:33:33"));
req.setOuterId("52340");
TmallLuxuryStageItemQueryRequest.PageDTO obj1 = new TmallLuxuryStageItemQueryRequest.PageDTO();
obj1.setPageSize(20L);
obj1.setCurrentPage(1L);
req.setPage(obj1);
req.setStatus("normal");
req.setIsPresale(1L);
TmallLuxuryStageItemQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_luxury_stage_item_query_response>
    <items>
        <item_query_response>
            <seller_id>1231455567</seller_id>
            <item_id>1235868786</item_id>
            <title>这是一个商品</title>
            <main_pic_url>商品主图</main_pic_url>
            <category_id>121448028</category_id>
            <price>123.56</price>
            <quantity>12</quantity>
            <with_holding_quantity>2</with_holding_quantity>
            <outer_id>233858</outer_id>
            <sold_quantity>34</sold_quantity>
            <create_time>2021-12-31 12:30:30</create_time>
            <modify_time>2021-12-31 12:30:30</modify_time>
            <starts_time>2021-12-31 12:30:30</starts_time>
            <status>0</status>
            <is_presale>1</is_presale>
        </item_query_response>
    </items>
    <page>
        <total_page>1</total_page>
        <page_size>20</page_size>
        <total_count>19</total_count>
        <current_page>1</current_page>
    </page>
</tmall_luxury_stage_item_query_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

返回
顶部