考拉推荐商品列表
51人使用

此接口没有返回分页参数,需要自己判断是否还有下一页,或者只取一页商品,最为推荐商品使用。

考拉一级类目ID表:

一级类目ID

一级类目名称

110022

宠物

9691

服装鞋靴

381

个人洗护

836

环球美食

372

家居生活

437

美容彩妆

438

母婴

8096

汽车用品

8115

生鲜

1092

手表配饰

440

数码家电

1025

箱包

837

医药健康

7578

运动户外

接口地址: http://api.tbk.dingdanxia.com/kaola/query_recommend_goodsList 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

sid

String

123456

自定义渠道跟单参数

categoryId

Long

类目ID

sortType

Integer

1:按佣金比例排序 默认 2:按佣金排序 3:按黑卡价格排序 4:按普通价格排序 5:按30天黑卡用户销量排序 6:按黑卡价差进行排序

desc

Integer

0 倒序 默认 1 升序 

self

Integer

0 全部 1 自营 2 非自营

pageNo

Integer

1 页码

pageSize

Integer

每页数量 默认 20

返回参数说明

标记

类型

例子

说明

BaseInfo

String[]

商品信息

L goodsTitle

String

商品名称

L goodsSubTitle

String

商品副标题

L imageList

List<String>

商品图片地址

L self

Integer

是否自营 0 否 1 是

L brandName

String

品牌名

L brandCountryName

String

品牌国简称

L groupBuyGoods

Integer

是否拼团商品 0 否 1 是

L onlineStatus

Integer

上架状态  1上架,0下架

L interPurch

Integer

是否内购 1 是 0 否

L store

Integer

是否有库存 0 否 1 是

L detailImgList

List<String>

页面图文详情中的图片

L importType

Integer

贸易类型 0 直邮 1 保税 2 海淘  3 国内贸易  4 个人清关

CategoryInfo

String[]

分类信息

L categoryId

Long

类目id

L categoryName

String

类目名

L level

Integer

层级

PriceInfo

String[]

价格信息

L currentPrice

BigDecimal

当前价格(普通会员享受的价格)

L newUserPrice

BigDecimal

新用户促销价格

L memberCurrentPrice

BigDecimal

黑卡会员专享价

L groupBuyPrice

BigDecimal

拼团价格(如果是拼团商品)

L marketPrice

BigDecimal

市场价

L memberPriceSpread

BigDecimal

黑卡会员与p普通会员价差(currentPrice-memberCurrentPrice)

ActivityInfo

String[]

活动信息

L noPostage

Integer

是否包邮 0 否 1 是

L activityLable

String

活动标签(多个标签逗号分隔)

L singleTaxReduction

Integer

是否单品减税 0否

CommissionInfo

String[]

佣金信息

L commissionRate

BigDecimal

一般佣金比例

L groupBuyCommissionRate

BigDecimal

拼团佣金比例 (如果是拼团商品

L expireType

Integer

一般佣金有效期 1 长期有效 0 时间段有效

L startTime

String

一般佣金开始时间 yyyy-mm-dd HH:mm:ss

L endTime

String

一般佣金结束时间yyyy-mm-dd HH:mm:ss

L groupBuyExpireType

Integer

拼团佣金有效期 1 长期有效 0 时间段有效

L groupBuyStartTime

String

拼团佣金开始时间 yyyy-mm-dd HH:mm:ss

L groupBuyEndTime

String

拼团佣金结束时间 yyyy-mm-dd HH:mm:ss

LinkInfo

String[]

推广信息

L shareUrl

String

分享链接

L shortShareUrl

String

分享短连接

L groupBuyShareUrl

String

拼团分享链接。如果是拼团商品

L groupBuyShortShareUrl

String

拼团分享短链。如果是拼团商品

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": [{
		"activityInfo": {
			"noPostage": 1
		},
		"baseInfo": {
			"brandCountryName": "日本",
			"brandName": "Ariel 碧浪",
			"detailImgList": [
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_0,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_1000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_1500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_2000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_2500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_3000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_3500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_4000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_4500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_5000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_5500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_6000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_6500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_7000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_7500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_8000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_8500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_9000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_9500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_10000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_10500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_11000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_11500,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_12000,w_750,h_500",
				"https://kaola-haitao.oss.kaolacdn.com/a8a81e22-7f39-43f6-a3c0-0d3457773821.jpg?x-oss-process=image/crop,x_0,y_12500,w_750,h_500"
			],
			"goodsSubTitle": "",
			"goodsTitle": "Ariel 碧浪机洗超净除菌洗衣液700克",
			"groupBuyGoods": 0,
			"imageList": [
				"https://kaola-haitao.oss.kaolacdn.com/47ebea2c-2e74-44ca-b374-e87e55341d2f.jpg",
				"https://kaola-haitao.oss.kaolacdn.com/f9114fbf-20fb-4b7a-b307-12358a26b726.jpg",
				"https://kaola-haitao.oss.kaolacdn.com/18534c54-f394-480e-bcff-7696f4d705b6.jpg",
				"https://kaola-haitao.oss.kaolacdn.com/64c3a5af-8a49-4662-9843-673a751d8439.jpg",
				"https://kaola-haitao.oss.kaolacdn.com/b7f18e3f-9eb0-4997-998e-28beee0b3ea3.jpg",
				"https://kaola-haitao.oss.kaolacdn.com/28aeca2f-d69e-41ed-9bd2-98c9415cd207.jpg",
				"https://kaola-haitao.oss.kaolacdn.com/e97af025-769b-4a89-a255-fc962e42ed3f.jpg"
			],
			"importType": 3,
			"interPurch": 0,
			"onlineStatus": 1,
			"self": 1,
			"store": 1
		},
		"categoryInfo": [{
				"categoryId": 372,
				"categoryName": "家居生活",
				"level": 2
			},
			{
				"categoryId": 1143,
				"categoryName": "家居清洁",
				"level": 3
			},
			{
				"categoryId": 2412,
				"categoryName": "衣物清洁护理剂",
				"level": 4
			},
			{
				"categoryId": 2458,
				"categoryName": "常规洗衣液",
				"level": 5
			}
		],
		"commissionInfo": {
			"commissionRate": 0.45,
			"endTime": "2021-08-15 23:59:59",
			"expireType": 0,
			"startTime": "2021-08-03 00:00:00"
		},
		"goodsId": 10199643,
		"linkInfo": {
			"goodsDetailUrl": "https://m-goods.kaola.com/product/10199643.html",
			"goodsPCUrl": "https://goods.kaola.com/product/10199643.html",
			"miniShareUrl": "https://cps.kaola.com/cps/mini/zhuankeLogin?unionId=zhuanke_701377920&tc1=4dingdanxia123456&tc2=4dingdanxia123456&showWapBanner=0&rd=259200000&targetUrl=https%3A%2F%2Fm-goods.kaola.com%2Fproduct%2F10199643.html%3F__da_dad3e203_5c4e7c4025b92c00",
			"shareUrl": "https://cps.kaola.com/cps/zhuankeLogin?unionId=zhuanke_701377920&tc1=4dingdanxia123456&tc2=4dingdanxia123456&showWapBanner=0&targetUrl=https%3A%2F%2Fm-goods.kaola.com%2Fproduct%2F10199643.html%3F__da_dad3e203_5c4e7c4025b92c00",
			"shortShareUrl": "http://lu.kaola.com/4b1sDP"
		},
		"priceInfo": {
			"currentPrice": 8,
			"marketPrice": 39,
			"memberCurrentPrice": 8,
			"memberPriceSpread": 0
		}
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。