淘客超级搜索功能接口 - 淘宝天猫商品搜索接口

淘客商品搜索API

根据关键词搜索商品及相关信息，打造个性化内容聚合导购网站或购物搜索网站。

接口介绍

请求协议：http/https
请求方式：get/post
返回类型：json
请求接口：http://api.daicuo.cc/taobao/search/
请求示例：http://api.daicuo.cc/taobao/search/?token=xxxxxx&q=%E5%A5%B3%E8%A3%85
请求扣点：免费
根据关键词搜索商品及相关信息，打造个性化内容聚合导购网站或购物搜索网站。

请求参数

参数名	类型	必填	示例值	描述
token	string	是	xxxxxx	API令牌（登录后会自动获取）
q	string	是	女装	关键词
cat	string	否	16,1512	类目ID：用,分割，最大10个，该ID可以通过taobao.itemcats.get接口获取到
page	number	否	1	第几页，默认：1
limit	number	否	20	页大小，默认：20
sort	srting	否	total_sales	排序字段：销量（total_sales）/默认，淘客佣金比率（tk_rate），累计推广量（tk_total_sales），总支出佣金（tk_total_commi），价格（price）
order	srting	否	desc	排序方式：倒序（desc）/默认，升序（asc）
material_id	number	否	17004	物料id，默认：17004
has_coupon	bool	否	false	优惠券筛选-是否有优惠券，默认：false
is_overseas	bool	否	false	商品筛选-是否海外商品，默认：false
is_tmal	bool	否	false	商品筛选-是否天猫商品，默认：false

响应参数

参数名	类型	示例值	描述
code	number	200	状态码
message	string	成功	返回状态提示
page	array	[...]	分页信息
list	array	[...]	商品列表
category_id	number	162201	商品信息-叶子类目id
category_name	string	连衣裙	商品信息-叶子类目名称
coupon_amount	string	99.00	优惠券（元）
coupon_end_time	string	2017-10-29	优惠券信息-优惠券结束时间
coupon_id	string	45f2c58cb3254170884970ed50c863fa	优惠券信息-优惠券id
coupon_info	string	满299元减20元	优惠券信息-优惠券满减信息
coupon_remain_count	number	888	优惠券信息-优惠券剩余量
coupon_start_fee	string	29.00	优惠券信息-优惠券起用门槛，满X元可用。
coupon_start_time	string	2017-10-29	优惠券信息-优惠券开始时间
coupon_total_count	number	10000	优惠券信息-优惠券总量
item_description	string	季凉被全棉亲肤	商品信息-宝贝描述(推荐理由)
item_id	number	610485674642	商品信息-宝贝id
level_one_category_id	number	20	商品信息-一级类目ID
level_one_category_name	string	女装	商品信息-一级类目名称
nick	string	旗舰店	店铺信息-卖家昵称
pict_url	string	https://img.alicdn.com/bao/uploaded/...	商品信息-商品主图
provcity	string	杭州	商品信息-宝贝所在地
reserve_price	number	102.00	商品信息-商品一口价格
seller_id	number	123456	店铺信息-卖家id
shop_dsr	number	4.6	店铺信息-店铺dsr评分
shop_title	string	xx旗舰店	店铺信息-店铺名称
short_title	string	2020新款轻薄圆领保暖内胆羽绒服	商品信息-商品短标题
small_images	array	[...]	商品信息-商品小图列表
title	string	毛呢阔腿裤港味复古女裤子	商品信息-商品标题
user_type	number	1	店铺信息-卖家类型。0表示集市，1表示天猫
volume	number	123	商品信息-30天销量（饿了么卡券信息-总销量）
white_image	string	https://img.alicdn.com/bao/uploaded/i4/745957850/...	商品信息-商品白底图
zk_final_price	string	88.00	折扣价（元）若属于预售商品，付定金时间内，折扣价=预售价

状态码说明

状态码	结果	描述
200	成功	接口正常返回数据
199	失败	处理积分失败，需联系管理员
198	失败	积分不足，请充值后再使用
197	失败	Api应用已下线，请勿再使用
194	失败	内部服务器错误，需联系管理员
0	失败	token错误或未填写

响应示例

{
	"code": 200,
	"msg": "成功",
	"time": "1609351798",
	"data": {
		"total": 8362068,
		"page": 1,
		"limit": 2,
		"last": 4181034,
		"list": [{
			"category_id": "1629",
			"category_name": "大码女装",
			"coupon_id": [],
			"coupon_info": [],
			"coupon_remain_count": "0",
			"coupon_total_count": "0",
			"item_description": "女神新衣 舒适面料 收藏加购 优先发货",
			"item_id": "628431851624",
			"level_one_category_id": "16",
			"level_one_category_name": "女装/女士精品",
			"nick": "伊洛遇旗舰店",
			"pict_url": "https://img.alicdn.com/bao/uploaded/i2/2201401485283/O1CN01pOl99J1otf2WblZq5_!!2201401485283-0-lubanu-s.jpg",
			"provcity": "浙江 杭州",
			"reserve_price": "65",
			"seller_id": "2201401485283",
			"shop_dsr": "47437",
			"shop_title": "伊洛遇旗舰店",
			"short_title": "大码女装2020年新款秋冬中长款卫衣",
			"small_images": {
				"string": ["https://img.alicdn.com/i2/2201401485283/O1CN01JvrBsY1otf2STJRoj_!!2201401485283-0-lubanu-s.jpg", "https://img.alicdn.com/i2/2201401485283/O1CN01ZCjT1W1otf2STG5uD_!!2201401485283-0-lubanu-s.jpg", "https://img.alicdn.com/i1/2201401485283/O1CN01ZRyLEu1otf2W0nSkS_!!2201401485283-0-lubanu-s.jpg", "https://img.alicdn.com/i2/2201401485283/O1CN01t9YgrT1otf2NnLs0k_!!2201401485283-2-lubanu-s.png"]
			},
			"title": "大码女装2020年新款秋冬中长款连帽卫衣女宽松韩版慵懒风涂鸦外套",
			"user_type": "1",
			"volume": "102",
			"white_image": "https://img.alicdn.com/bao/uploaded/O1CN010HOF681pjsCKlD8iE_!!6000000005397-2-yinhe.png",
			"zk_final_price": "36.9"
		}]
	}
}