[1688一件代发]API接口关键词搜索（1688.item_search）

以下是关于 1688 的一件代发在 API 接口方面关键词搜索和所有商品搜索的相关信息：

一、关键词搜索 API 接口：

功能：通过输入特定的关键词，从 1688 平台庞大的商品库中搜索出相关的商品信息。这对于想要快速找到特定类型或特定名称商品的开发者或商家非常有用。
参数设置：
q：这是最关键的参数，代表搜索的关键字。例如，如果想搜索 "充电宝"，则q的值就设为 "充电宝"。
start_price和end_price：用于设置价格范围，可根据需求搜索特定价格区间的商品。比如start_price=50、end_price=100，表示搜索价格在 50 元到 100 元之间的商品。
page：指定返回结果的页码，1688 的搜索结果通常会分页展示，通过设置不同的page值可以获取不同页的商品信息。
page_size：设置每页显示的商品数量，默认一般为 40，但可以根据需求进行调整。
sort：用于设置商品的排序方式，如按价格从低到高（price）、销量从高到低（_sale）等。
filter：额外的过滤参数，可以根据一些特定的条件进行筛选，如过滤掉不支持 7 天无理由退换货的商品等。
请求示例（以 curl 为例）：

1688.item_search

公共参数

请求地址: https://api-gw.onebound.cn/1688/item_search

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	点击注册账号获取key和secret
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:搜索关键字

start_price:开始价格

end_price:结束价格

sort:排序[bid,_bid,_sale,]

(bid:总价,sale:销量)

page:页数 page_size:每页宝贝数量，默认40

quantityBegin 起订量：数字

filter:totalEpScoreLv1(综合评分),getRate24HLv1(24小时揽收率),具体联系业务

响应参数

Version: Date:

名称	类型	必须	示例值	描述
items	items[]	0		按关键字搜索商品

请求示例

-- 请求示例 url 默认请求参数已经URL编码处理

curl -i "https://api-gw.onebound.cn/1688/item_search https://api-gw.onebound.cn/1688/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&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="

在使用 1688 的 API 接口时，需要先申请获得相应的apikey和apisecret，并且要遵守 1688 平台的 API 使用规则和相关法律法规。不同的开发者平台或第三方服务提供商可能会对这些接口进行一定的封装和优化，使用方法可能会略有差异。

API 工具

API SDK下载