以下是1688关键词搜索 API 返回值说明、简单调用示例。
需要更多了解和测试调用请移步
http://console.open.onebound.cn/console/?i=Turbo
公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key 点击获取测试key和secret |
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:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,_sale,_credit]
(bid:总价,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数 page_size:每页宝贝数量,默认40
filter:额外的过滤参数,如:filter=filtId:1,2,3,4;activityType:1,2,3,4;city:天津;quantityBegin:1000
filtId 过滤:48小时发货,7+天包换,赠运费险,免费赊账;
activityType 优惠类型:包邮,产地货源,伙拼,手机专享价
city 地区:地区名
quantityBegin 起订量:数字
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
items |
items[] | 0 | 按关键字搜索商品 | |
page |
Int | 0 | 1 | 页码 |
real_total_results |
Int | 0 | 1900 | 宝贝数量 |
total_results |
Int | 0 | 1900 | 宝贝数量 |
page_size |
Int | 0 | 20 | 接口返回数量 |
pagecount |
Int | 0 | 120 | 总页数 |
data_from |
String | 0 | ||
item |
item[] | 0 | 宝贝详情数据 | |
title |
String | 0 | 圆形服装店吊牌定做女装衣服吊卡订制800g加厚烘培礼品花卉卡片 | 商品标题 |
pic_url |
String | 0 | https://cbu01.alicdn.com/img/ibank/2020/386/208/22202802683_1873238575.search.jpg | 宝贝图片 |
promotion_price |
Float | 0 | 138.00 | 优惠价 |
price |
Float | 0 | 138.00 | 价格 |
sales |
Int | 0 | 4470 | 销量 |