文档中心 > API类目 > 国际站商品API

alibaba.icbu.product.list (商品查询)

根据类目ID和商品名称查询商品概要信息。结果以修改时间倒序返回,支持分页,每页最多30个。每次调用都是独立的请求,不记录调用的上下文。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
category_id Number 可选 123 类目ID
current_page Number 可选 1
  • 默认值:1
  • 当前页
    page_size Number 可选 10
  • 默认值:10
  • 每页大小,最大30
    subject String 可选 mp3 商品名称,支持模糊匹配
    language String 必须 ENGLISH 商品语种,目前只支持ENGLISH
    group_id3 Number 可选 111 商品三级分组id,可选填。若填写-1 则表示取回的商品没有三级分组,不填入代表取回的商品不关心它的三级分组,填写对应的group id将返回这个分组下的商品
    group_id2 Number 可选 222 商品二级分组id,可选填。若填写-1 则表示取回的商品没有二级分组,不填入代表取回的商品不关系它的二级分组,填写对应的group id将返回这个分组下的商品
    group_id1 Number 可选 333 商品一级分组id,可选填。若填写0 则表示取回的商品没有一级分组,不填入代表取回的商品不关心它的一级分组,填写对应的group id将返回这个分组下的商品
    id Number 可选 6377362837 商品明文id
    gmt_modified_to String 可选 2020-12-22 12:00:00 最晚修改时间,格式yyyy-MM-dd HH:mm:ss
    gmt_modified_from String 可选 2020-12-22 12:00:00 最早修改时间,格式yyyy-MM-dd HH:mm:ss

    响应参数

    名称 类型 示例值 描述
    current_page Number 2 当前页
    page_size Number 20 每页大小
    products AlibabaProductBriefResponse [] 商品概要信息列表
    • └ group_id
    • Number
    • 456
    • 分组ID
    • └ group_name
    • String
    • best seller
    • 分组名称
    • └ id
    • Number
    • 123
    • 商品明文ID
    • └ keywords
    • String []
    • ["mp3","player"]
    • 关键词
    • main_image
    • MainImage
    • 商品的主图
    • └ images
    • String []
    • ["http://g03.s.alicdn.com/kf/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg/200042360/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg.jpg","http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg"]
    • alibaba图片中心的图片URL列表,请使用alibaba.icbu.photobank.upload接口上传图片
    • └ watermark
    • Boolean
    • true
    • 是否打水印,是(true)或否(false)
    • └ watermark_frame
    • String
    • N
    • 水印是否有边框,有边框(Y)或者无边框(N)
    • └ watermark_position
    • String
    • center
    • 水印位置,在中间(center)或者在底部(bottom)
    • └ status
    • String
    • approved
    • 商品状态
    • └ subject
    • String
    • mp3 player
    • 商品名称
    • └ product_type
    • String
    • 产品类型
    • sourcing或者wholesale
    • └ language
    • String
    • 语言种类
    • english
    • └ display
    • String
    • 是否上下架
    • Y表示上架,N表示下架
    • └ owner_member_display_name
    • String
    • 产品负责人
    • james
    • └ category_id
    • Number
    • 类目id
    • 1234
    • └ is_specific
    • Boolean
    • 是否是规格品
    • true
    • └ is_rts
    • Boolean
    • 是否是rts品
    • true
    • └ pc_detail_url
    • String
    • 商品详情链接
    • https://www.alibaba.com/product-detail/Eco-Friendly-100-Biodegradable-Cornstarch-Trash_60832548452.html?spm=a2700.galleryofferlist.normalList.12.6c612db4ueHAW2&fullFirstScreen=true
    • └ smart_edit
    • Boolean
    • 是否智能编辑
    • true
    • └ gmt_create
    • Date
    • 创建时间
    • 2020-12-22 12:00:00
    • └ gmt_modified
    • Date
    • 修改时间
    • 2020-12-22 12:00:00
    • └ red_model
    • String
    • 型号
    • CK001
    • └ product_id
    • String
    • 6edvniewvnewovn
    • 产品混淆id
    total_item Number 123 总数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaIcbuProductListRequest req = new AlibabaIcbuProductListRequest();
    req.setCategoryId(123L);
    req.setCurrentPage(1L);
    req.setPageSize(10L);
    req.setSubject("mp3");
    req.setLanguage("ENGLISH");
    req.setGroupId3(111L);
    req.setGroupId2(222L);
    req.setGroupId1(333L);
    req.setId(6377362837L);
    req.setGmtModifiedTo("2020-12-22 12:00:00");
    req.setGmtModifiedFrom("2020-12-22 12:00:00");
    AlibabaIcbuProductListResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_icbu_product_list_response>
        <current_page>2</current_page>
        <page_size>20</page_size>
        <products>
            <alibaba_product_brief_response>
                <group_id>456</group_id>
                <group_name>best seller</group_name>
                <id>123</id>
                <keywords>
                    <string>[&quot;mp3&quot;</string>
                    <string>&quot;player&quot;]</string>
                </keywords>
                <main_image>
                    <images>
                        <string>[&quot;http://g03.s.alicdn.com/kf/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg/200042360/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg.jpg&quot;</string>
                        <string>&quot;http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg&quot;]</string>
                    </images>
                    <watermark>true</watermark>
                    <watermark_frame>N</watermark_frame>
                    <watermark_position>center</watermark_position>
                </main_image>
                <status>approved</status>
                <subject>mp3 player</subject>
                <product_type>产品类型</product_type>
                <language>语言种类</language>
                <display>是否上下架</display>
                <owner_member_display_name>产品负责人</owner_member_display_name>
                <category_id>类目id</category_id>
                <is_specific>是否是规格品</is_specific>
                <is_rts>是否是rts品</is_rts>
                <pc_detail_url>商品详情链接</pc_detail_url>
                <smart_edit>是否智能编辑</smart_edit>
                <gmt_create>创建时间</gmt_create>
                <gmt_modified>修改时间</gmt_modified>
                <red_model>型号</red_model>
                <product_id>6edvniewvnewovn</product_id>
            </alibaba_product_brief_response>
        </products>
        <total_item>123</total_item>
    </alibaba_icbu_product_list_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>

    错误码解释

    错误码 错误描述 解决方案
    isp.list.product.error 查询商品错误 请重试,或联系服务人员

    API工具

    如何获得此API

    FAQ

    返回
    顶部