taobao.mcn.shop.item.page.get (商品清单)

商家授权; 分页查询, 店铺的近三个月修改过的商品简易信息清单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cid Number 可选 1512 商品类目id
page_no Number 必须 1 页码。正整数,默认值为1。当深翻时(page_no*page_size>1万),为了性能考虑,部分接口将报错。请尽可能细化搜索,如:根据时间分段
page_size Number 必须 40 每页获取条数。正整数,默认值10,最大值100。
start_date Date 必须 2022-11-01 00:00:00 起始修改时间,三个月内,注意部分接口支持时间区间有限,当时间点过于不合理可能查询报错
end_date Date 必须 2023-01-01 00:00:00 结束修改时间,三个月内,注意部分接口支持时间区间有限,当时间点过于不合理可能查询报错

响应参数

名称 类型 示例值 描述
total_count Number 998 数据总数
shop_item_page_response_list ShopItemPageResponse [] 响应结果
  • └ num_iid
  • Number
  • 23434343
  • 商品id
  • └ approve_status
  • String
  • onsale
  • 商品上传后的状态
  • └ pic_url
  • String
  • http://ix.jpg
  • 商品主图
  • └ title
  • String
  • title
  • 商品名称
  • └ price
  • String
  • 5.00
  • 商品价格
  • └ type
  • String
  • (fixed:一口价;auction:拍卖)
  • 商品类型
  • └ cid
  • Number
  • 1512
  • 商品类目id
  • └ seller_cids
  • String
  • 2234445,3344466,44643
  • 商品所属的店铺内卖家自定义类目列表
  • sku
  • Sku []
  • true
  • Sku列表
  • └ barcode
  • String
  • 343434
  • 商品级别的条形码
  • └ 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
  • └ outer_id
  • String
  • 234343
  • 商家设置的外部id
  • └ modified
  • Date
  • 2011-01-01 00:00:00
  • 修改时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
McnShopItemPageGetRequest req = new McnShopItemPageGetRequest();
req.setCid(1512L);
req.setPageNo(1L);
req.setPageSize(40L);
req.setStartDate(StringUtils.parseDateTime("2022-11-01 00:00:00"));
req.setEndDate(StringUtils.parseDateTime("2023-01-01 00:00:00"));
McnShopItemPageGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<mcn_shop_item_page_get_response>
    <total_count>998</total_count>
    <shop_item_page_response_list>
        <shop_item_page_response>
            <num_iid>23434343</num_iid>
            <approve_status>onsale</approve_status>
            <pic_url>http://ix.jpg</pic_url>
            <title>title</title>
            <price>5.00</price>
            <type>(fixed:一口价;auction:拍卖)</type>
            <cid>1512</cid>
            <seller_cids>2234445,3344466,44643</seller_cids>
            <sku>
                <sku>
                    <barcode>343434</barcode>
                    <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>
                    <outer_id>234343</outer_id>
                    <modified>2011-01-01 00:00:00</modified>
                </sku>
            </sku>
        </shop_item_page_response>
    </shop_item_page_response_list>
</mcn_shop_item_page_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

返回
顶部