在互联网搜索购物的时代,商品列表可以帮助我们的顾客更好的更有方向和目的的搜寻到自己需要的商品,那么商品列表APi的接入就成为我们商家必不可少的运营要素。
商品列表一般包含哪些参数呢?如何接入简单快捷方便且稳定的商品列表API接口呢?
item_recommend-获取推荐商品列表
taobao.item_recommend
公共参数
请求地址: https://api-gw…….cn/taobao/item_recommend
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
请求参数
请求参数:type=
参数说明:type:推荐类型
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
title |
String | 0 | 春秋季长袖睡衣女 100 纯棉V领全棉休闲家居服秋冬女士套装可外穿 | 宝贝标题 |
num_iid |
Bigint | 0 | 575382424992 | 宝贝ID |
price |
Float | 0 | 329.00 | 价格 |
sales |
Int | 0 | 31 | 销量 |
orginal_price |
Float | 0 | 329.00 | 原价 |
promotion_price |
Float | 0 | 118.00 | 优惠价 |
pic_url |
String | 0 | https://img.alicdn.com/bao/uploaded/i1/2980881979/O1CN011QUQGRKySwSWVkf_!!2980881979.jpg | 宝贝图片 |
detail_url |
String | 0 | https://detail.tmall.com/item.htm?id=575382424992 | 宝贝链接 |
commission_rate |
Float | 0 | 310.00 | |
coupon_start_time |
Date | 0 | 2020-12-13 | 开始时间 |
coupon_end_time |
Date | 0 | 2020-12-19 | 结束时间 |
coupon_info |
String | 0 | 满89元减5元 | 所在地 |
provcity |
String | 0 | 河南 郑州 | 所在地 |
seller_id |
Bigint | 0 | 2980881979 | 卖家ID |
seller_nick |
String | 0 | 耶蒂旗舰店 | 掌柜昵称 |
shop_title |
String | 0 | 耶蒂旗舰店 | 店铺名 |
images |
Mix | 0 | {"https://img.alicdn.com/i4/2980881979/O1CN011QUQGSkj7sUdPTQ_!!2980881979.jpg"} | 图片地址 |
如何接入?
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw.…….cn/taobao/item_recommend/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&type="
Onebound TAOBAO API SDK调用示例:
Onebound TAOBAO API SDK下载地址
参数说明
- 通用参数说明
- 参数不要乱传,否则不管成功失败都会扣费
- url说明 https://api-gw.onebound.cn/平台/API类型/ 平台:淘宝,京东等, API类型:[item_search,item_get,item_search_shop等]
- version:API版本
- key:调用key,测试key:test_api_key
- secret:调用secret,测试secret:(不用填写)
- cache:[yes,no]默认yes,将调用缓存的数据,速度比较快
- result_type:[json,xml,serialize,var_export]返回数据格式,默认为json
- lang:[cn,en,ru] 翻译语言,默认cn简体中文
- secret:密钥
-
API:item_search 参数说明:
- q:搜索关键字
- cat:分类ID
- start_price:开始价格
- end_price:结束价格
- sort:排序[bid,bid,bid2,_bid2,_sale,_credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加前缀为从大到小排序) - page:页数
- page_size:每页宝贝数量,默认40
- seller_info:是否获取商家信息[yes,no],默认yes
-
API:item_get 参数说明: num_iid:宝贝ID