文档中心 > API类目 > 货源服务API

taobao.itemmarket.item.searching (获取货品信息)

获取货品信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 必须 20
  • 默认值:20
  • 分页大小
    query_word String 可选 "男装" 搜索词
    current_page Number 必须 1
  • 默认值:1
  • 当前页码
    query_category_id Number 可选 16 搜索类目 id
    min_price Number 可选 0 最低价格
    max_price Number 可选 1000 最高价格
    tag_list String 可选 "DELIVERY_AGENT_ONE, AUTHENTIC_MATERIAL" 三方货源标签列表(DELIVERY_AGENT_ONE:一件代发,DELIVERY_48_HOUR:48小时发货,DELIVERY_24_HOUR:24小时发货,DELIVERY_3_DAY:72小时发货,AUTHENTIC_MATERIAL:实拍商品,REFUND_8_DAY:8天包退,QUALITY_STALL:实力商家)
    sorting_condition_map Json 可选 {"price":"false"} 排序条件(score:综合,last_30_sold_quantity,销量,price:价格,old_starts:发布时间),fasle升序,true降序

    响应参数

    名称 类型 示例值 描述
    data ApiResult {} 返回对象
    • result
    • ImSearchingResponse
    • 返回结果
    • item_list
    • ImThirdItemCard []
    • 货品列表
    • └ id
    • Number
    • 706304884916
    • 货品在货源的 id
    • └ title
    • String
    • "夏季男装Polo衫短袖商务绅士直筒型薄款"
    • 货品标题
    • └ pict_url
    • String
    • "https://img.alicdn.com/imgextra/i4/12336927/O1CN01v6jSzq212cMcbAyR1_!!12336927-0-third_party_goods_pic.jpg"
    • 封面图
    • └ price
    • Number
    • 55
    • 货品单价
    • └ monthly_sales_volume
    • Number
    • 0
    • 月销量
    • third_vendor
    • ImThirdVendorVO
    • 服务商信息
    • └ id
    • Number
    • 7
    • 服务商id
    • └ ap_description
    • String
    • "网货批发基地,支持商品一键上传至淘系店铺,支持一件代发、15天包退、48小时极速发货。"
    • 小程序介绍
    • └ app_name
    • String
    • "优批之家"
    • 小程序名称
    • └ tag_list
    • String []
    • 货品标签
    • sku_info
    • ImItemSkuInfoVO
    • sku 信息
    • sku_list
    • ImItemSkuDetailVO []
    • sku 信息
    • └ id
    • Number
    • 4979498129788
    • sku id
    • └ outer_id
    • String
    • "HZ-SJ-1109-3-CS12-白色-M"
    • 服务商侧 sku id
    • └ price
    • String
    • 29.00
    • 价格
    • └ quantity
    • Number
    • 100
    • 数量
    • └ value_text_list
    • String []
    • 属性值文案
    • └ stall_id
    • Number
    • 208
    • 档口 id
    • └ tb_sales_volume
    • String
    • "0"
    • 模糊化的淘宝侧销量
    • └ category_id
    • Number
    • 16
    • 类目
    • └ total_num
    • Number
    • 160651
    • 总数
    • └ call_success
    • Boolean
    • true
    • 查询是否成功
    • └ call_error_code
    • String
    • 1001
    • 错误码
    • └ call_error_msg
    • String
    • SystemError
    • 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ItemmarketItemSearchingRequest req = new ItemmarketItemSearchingRequest();
    req.setPageSize(20L);
    req.setQueryWord("\"男装\"");
    req.setCurrentPage(1L);
    req.setQueryCategoryId(16L);
    req.setMinPrice(0L);
    req.setMaxPrice(1000L);
    req.setTagList("\"DELIVERY_AGENT_ONE, AUTHENTIC_MATERIAL\"");
    req.setSortingConditionMapString("{\"price\":\"false\"}");
    ItemmarketItemSearchingResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <itemmarket_item_searching_response>
        <data>
            <result>
                <item_list>
                    <im_third_item_card>
                        <id>706304884916</id>
                        <title>&quot;夏季男装Polo衫短袖商务绅士直筒型薄款&quot;</title>
                        <pict_url>&quot;https://img.alicdn.com/imgextra/i4/12336927/O1CN01v6jSzq212cMcbAyR1_!!12336927-0-third_party_goods_pic.jpg&quot;</pict_url>
                        <price>55</price>
                        <monthly_sales_volume>0</monthly_sales_volume>
                        <third_vendor>
                            <id>7</id>
                            <ap_description>&quot;网货批发基地,支持商品一键上传至淘系店铺,支持一件代发、15天包退、48小时极速发货。&quot;</ap_description>
                            <app_name>&quot;优批之家&quot;</app_name>
                        </third_vendor>
                        <sku_info>
                            <sku_list>
                                <im_item_sku_detail_v_o>
                                    <id>4979498129788</id>
                                    <outer_id>&quot;HZ-SJ-1109-3-CS12-白色-M&quot;</outer_id>
                                    <price>29.00</price>
                                    <quantity>100</quantity>
                                </im_item_sku_detail_v_o>
                            </sku_list>
                        </sku_info>
                        <stall_id>208</stall_id>
                        <tb_sales_volume>&quot;0&quot;</tb_sales_volume>
                        <category_id>16</category_id>
                    </im_third_item_card>
                </item_list>
                <total_num>160651</total_num>
            </result>
            <call_success>true</call_success>
            <call_error_code>1001</call_error_code>
            <call_error_msg>SystemError</call_error_msg>
        </data>
    </itemmarket_item_searching_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

    返回
    顶部