以下是关于 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 天无理由退换货的商品等。
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简体中文
请求参数：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 按关键字搜索商品
请求示例
Curl
PHP
PHPsdk
JAVA
C#
Python
Golang
javascript
JS-SDK
Ruby
Swift
Objective-C
C
C++
Node.JS
Kotlin
Rust
R
MATLAB
复制
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "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="
响应示例
复制
{
"items": {
"page": "1",
"real_total_results": 1900,
"total_results": 1900,
"page_size": 19,
"page_count": 100,
"item": [
{
"title": "2019 wish 跨境秋季欧美爆板女装连衣裙 修身显瘦长款花朵吊带裙",
"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/636/393/14247393636_846235425.jpg",
"promotion_price": "17.00",
"price": "17.00",
"sales": 7000,
"num_iid": "45566582412",
"seller_nick": "广州伊霏凡服饰有限公司",
"tag_percent": "58.6%",
"area": "广州市",
"detail_url": "https://detail.1688.com/offer/45566582412.html"
},
{
"title": "连衣裙女2021春夏新款系带泡泡袖显瘦收腰碎花短裙外贸女装批发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/854/650/22828056458_1179464981.jpg",
"promotion_price": "17.00",
"price": "17.00",
"sales": 140000,
"num_iid": "631485240015",
"seller_nick": "普宁市燎原五笔蟹服装厂",
"tag_percent": "25.5%",
"area": "普宁市",
"detail_url": "https://detail.1688.com/offer/631485240015.htm
