考拉超级搜索接口
153人使用

搜索考拉所有可返佣商品

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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

keyWord

String

鞋子

搜索关键词

sid

String

123456

自定义渠道跟单参数

type

Integer

0

排序方式 0 综合排序 1 价格排序 2 销量排序 10 佣金比例排序 默认0排序方式

desc

BOOLEAN

true

是否降序,只对价格排序方式有效,默认降序 true 降序 flase 升序

pageNo

Integer

1

页码 默认第一页

pageSize

Integer

20

每次查询数量 默认20(可能返回的数据不准,因为官方接口原因过滤了没有佣金商品)

返回参数说明

标记

类型

例子

说明

ActivityInfo

String[]

活动信息

L noPostage

Integer

是否包邮 0 否 1 是

L activityLable

String

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

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

市场价

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

分享推广链接

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": {
		"dataList": [{
			"activityInfo": {
				"activityLable": "券满200减30,特价",
				"noPostage": 0
			},
			"baseInfo": {
				"brandCountryName": "澳大利亚",
				"brandName": "TARRAMARRA",
				"detailImgList": [
					"https://kaola-pop.oss.kaolacdn.com/21a829250221487dbd075fb129cc9ec0_750_1028.jpg",
					"https://kaola-pop.oss.kaolacdn.com/542ab6d3df184bb3a6d05b9372c309c7_750_693.jpg",
					"https://kaola-pop.oss.kaolacdn.com/d36ddb8c770d4ead9dd828954c37e62a_750_903.jpg",
					"https://kaola-pop.oss.kaolacdn.com/55ef849eb0014bde8a8ad458136e32ef_750_907.jpg",
					"https://kaola-pop.oss.kaolacdn.com/f224469918894340a1b2d512b38e9537_750_930.jpg",
					"https://kaola-pop.oss.kaolacdn.com/73d0d0f3ae3d4999be71c4d1b213cfa5_750_1054.jpg",
					"https://kaola-pop.oss.kaolacdn.com/27405514472b4a2787ea0b6cff04660c_750_961.jpg",
					"https://kaola-pop.oss.kaolacdn.com/9adbdefc84cf4e50b04336796c16f552_750_768.jpg",
					"https://kaola-pop.oss.kaolacdn.com/f16c960890e94ca1892603bec273506f_750_951.jpg",
					"https://kaola-pop.oss.kaolacdn.com/99ed16bc3ed94a71b0013e765635cdaf_750_1455.jpg",
					"https://kaola-pop.oss.kaolacdn.com/f174bc9665ce4be2a566087c51653683_750_998.jpg",
					"https://kaola-pop.oss.kaolacdn.com/4e2f9269d496408dbb20962e06b82657_750_838.jpg",
					"https://kaola-pop.oss.kaolacdn.com/a4c0e67d7a864e3b94ebeef6dc7c0789_750_873.jpg",
					"https://kaola-pop.oss.kaolacdn.com/3a685ec3a9d04be4bd794deac6c07e3b_750_1296.jpg",
					"https://kaola-pop.oss.kaolacdn.com/c5689c148ead4a0a9007058e9d8e93f1_750_1301.jpg",
					"https://kaola-pop.oss.kaolacdn.com/6508743e82fe481d8492484f7d3086be_750_837.jpg",
					"https://kaola-pop.oss.kaolacdn.com/61e9d0d58e384785ae6c386bc879f0c1_750_1542.jpg",
					"https://kaola-pop.oss.kaolacdn.com/adaaccf1231e44e69b539134be2f7be4_750_594.jpg",
					"https://kaola-pop.oss.kaolacdn.com/6ab7f8ffa98241f28f1dc7a26a2bbe9e_750_809.jpg",
					"https://kaola-pop.oss.kaolacdn.com/c7656ef85c9f44cfbedb11c9a2e8384a_750_1173.jpg"
				],
				"goodsSubTitle": "无后跟穆勒拖,随穿随拖超方便,橡胶耐磨大底,穿起来无负担,一脚蹬设计,黑白格纹标志布面, 超透气~舒适~不磨脚",
				"goodsTitle": "TARRAMARRA 帆布鞋女2021新款小香风平底单鞋包头半拖鞋女士休闲鞋 Delia TA5033",
				"groupBuyGoods": 0,
				"imageList": [
					"https://kaola-pop.oss.kaolacdn.com/0b06f2c7c7384611b54d65d496df9a6d_800_800.jpg",
					"https://kaola-pop.oss.kaolacdn.com/1c6583cfe9d344e1b59ddad0298399d5_800_800.jpg",
					"https://kaola-pop.oss.kaolacdn.com/7a5dd0c9e757403a88493fd0d193b188_800_800.jpg",
					"https://kaola-pop.oss.kaolacdn.com/5d00ee6f51ed46a5ad82313804dc5452_800_800.jpg",
					"https://kaola-pop.oss.kaolacdn.com/386afaab4a4341f3b7becf9faf145918_800_800.jpg",
					"https://kaola-pop.oss.kaolacdn.com/434980035a50412ba2cc61fe3ecd5dec_800_800.jpg",
					"https://kaola-pop.oss.kaolacdn.com/3e4b5a98bf02467c8c8426b44c7a291e_800_800.jpg"
				],
				"importType": 3,
				"interPurch": 0,
				"onlineStatus": 1,
				"self": 0,
				"store": 1
			},
			"categoryInfo": [{
					"categoryId": 9691,
					"categoryName": "服装鞋靴",
					"level": 2
				},
				{
					"categoryId": 1077,
					"categoryName": "女鞋",
					"level": 3
				},
				{
					"categoryId": 1725,
					"categoryName": "女士帆布鞋/运动鞋",
					"level": 4
				}
			],
			"commissionInfo": {
				"commissionRate": 0.04,
				"expireType": 1
			},
			"depositInfo": {
				"deposit": false,
				"depositEndTime": 0,
				"depositStartTime": 0,
				"payEndTime": 0,
				"payStartTime": 0
			},
			"goodsId": 10198936,
			"linkInfo": {
				"goodsDetailUrl": "https://m-goods.kaola.com/product/10198936.html",
				"goodsPCUrl": "https://goods.kaola.com/product/10198936.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%2F10198936.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%2F10198936.html%3F__da_dad3e203_5c4e7c4025b92c00"
			},
			"priceInfo": {
				"currentPrice": 199,
				"marketPrice": 599,
				"memberCurrentPrice": 189,
				"memberPriceSpread": 10
			}
		}],
		"pageNo": 1,
		"pageSize": 20,
		"total": 5000
	}
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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