一、引言
阿里巴巴关键字搜索商品API为电商企业提供了一个强大的工具,通过该API,企业可以实时获取与搜索关键字相关的商品信息,包括商品的详细描述、属性、价格、销售量等。这些信息对于电商企业而言至关重要,它们不仅可以帮助企业了解市场需求、用户行为以及商品趋势,还可以为企业的产品创新、营销策略制定等提供有力的数据支持。
二、API返回值详解
- 搜索结果概览
totalItems
:表示搜索到的商品总数,这个数字可以反映市场的整体规模。pagination
:分页信息,包括当前页码、每页数量等,有助于企业了解搜索结果的分页情况,便于进行更深入的探索。
- 商品详细信息
productId
:商品的唯一标识符,用于区分不同的商品。productTitle
:商品的标题,提供了商品的基本信息。productImage
:商品的图片链接,可以展示商品的外观。price
:商品的价格,是用户购买决策的重要因素之一。sales
:商品的销售量,反映了商品的受欢迎程度和市场接受度。supplier
:提供该商品的供应商信息,包括供应商名称、联系方式等,有助于企业建立供应链合作关系。category
:商品所属的类别,有助于企业了解商品在市场上的分类和定位。description
:商品的详细描述,提供了商品的详细信息和使用说明。attributes
:商品的属性列表,如颜色、尺寸、材质等,有助于企业了解商品的特性和卖点。
-
1688.item_search
公共参数
请求地址: https://api-gw.onebound.cn/1688/item_search
名称 类型 必须 描述 key String 是 调用key(必须以GET方式拼接在URL中) secret String 是 调用密钥 api_name String 是 API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] cache String 否 [yes,no]默认yes,将调用缓存的数据,速度比较快 result_type String 否 [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 lang String 否 [cn,en,ru]翻译语言,默认cn简体中文 version String 否 API版本 请求参数
请求参数:q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=40&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter=
参数说明:q:搜索关键字
sort:排序[bid,_bid,_sale,_credit]
(bid:总价,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数 page_size:每页宝贝数量,默认40响应参数
Version: Date:
名称 类型 必须 示例值 描述 items
items[] 0 按关键字搜索商品
响应示例