考拉商品详情接口
51人使用

查询商品详情信息

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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

sid

String

123456

自定义渠道跟单参数

goodsIds

String

9714044

商品ID

返回参数说明

标记

类型

例子

说明

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": "英尔德",
                "detailImgList": [
                    "https://kaola-pop.oss.kaolacdn.com/5199f899d0f246e69f760254486ce18e_750_1083.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/5fa3bd66e9ce49479df6b9a80c183022_750_1100.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/cb47cbf0cfba4860a57ee14318909ae3_750_1136.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/1b246e8938834bc89d37005c91b2ad57_750_550.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/84230b50dc4041b294671070cb700e16_750_1032.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/03376aa96d234420a5b8cf1a0bb67aae_750_1200.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/a47c90f3b3694cee8ba6dc876f6977b1_750_1098.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/3c745bf12a1f44a09189423b00ca2d88_750_1156.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/c5b726b124d849d3af50b8c69696d657_750_1050.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/863d866c5860491d8e0bd1bcd7de2059_750_936.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/4c9f0112055946c297203572a84474e1_750_1200.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/11651ddafaf94e3cb9a358bb2b6f28e3_750_1200.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/d84a0612794e460dbb7949d953565049_750_1121.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/db69387fb1f14c96aff810562e585b09_750_1296.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/ed5deb511ff94c13b0a1b0472d92be4b_750_1191.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/25e7011f753b4da49719c3f83d532249_750_886.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/fba176d64671455e9de5ef63ebd4342e_750_884.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/a7311ce4e4c042b0962db9ff90fa2c84_750_887.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/ac4015a7a0ff45ce9bbc4d9c2c98b453_750_885.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/8b2d2620c7134b3cbc2fdb32d1b3aaaa_750_886.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/9cc9e91cc70c475f9e8741d0b677633f_750_886.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/13e5dc0352f040c584b30e215113a913_750_886.jpg"
                ],
                "goodsSubTitle": "软壳硅胶手机壳,颜色款式多样。",
                "goodsTitle": "【超Q小怪兽】硅胶软壳可爱卡通系列苹果12华为P40Pro适用mate30软壳P40女磨砂iPhoneXR/SE",
                "groupBuyGoods": 0,
                "imageList": [
                    "https://kaola-pop.oss.kaolacdn.com/3685c9db289640d596e10c64fc920315_800_800.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/3865ddbadf0a4c5a978fe911406cf84a_800_800.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/009ac9b558454385ac005b0e51fb325b_800_800.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/1c308858be4a4d1ea2844a668d778b72_800_800.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/12d1de7d9ee14be18943bfd2d40af3f2_800_800.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/b4991edddaa84b5e94655015974ff9bb_800_800.jpg",
                    "https://kaola-pop.oss.kaolacdn.com/ee633fe91e2d4d618837eb6406be8b02_800_800.jpg"
                ],
                "importType": 3,
                "interPurch": 0,
                "onlineStatus": 1,
                "self": 0,
                "store": 1
            },
            "categoryInfo": [
                {
                    "categoryId": 440,
                    "categoryName": "数码家电",
                    "level": 2
                },
                {
                    "categoryId": 981,
                    "categoryName": "3C数码",
                    "level": 3
                },
                {
                    "categoryId": 983,
                    "categoryName": "手机/手机配件",
                    "level": 4
                },
                {
                    "categoryId": 2298,
                    "categoryName": "手机保护套",
                    "level": 5
                }
            ],
            "commissionInfo": {
                "commissionRate": 0.1,
                "expireType": 1
            },
            "goodsId": 9714044,
            "linkInfo": {
                "goodsDetailUrl": "https://m-goods.kaola.com/product/9714044.html",
                "goodsPCUrl": "https://goods.kaola.com/product/9714044.html",
                "miniShareUrl": "https://cps.kaola.com/cps/mini/zhuankeLogin?unionId=zhuanke_701377920&tc1=4dingdanxia12345&tc2=4dingdanxia12345&showWapBanner=0&rd=259200000&targetUrl=https%3A%2F%2Fm-goods.kaola.com%2Fproduct%2F9714044.html%3F__da_dad3e203_5c4e7c4025b92c00",
                "shareUrl": "https://cps.kaola.com/cps/zhuankeLogin?unionId=zhuanke_701377920&tc1=4dingdanxia12345&tc2=4dingdanxia12345&showWapBanner=0&targetUrl=https%3A%2F%2Fm-goods.kaola.com%2Fproduct%2F9714044.html%3F__da_dad3e203_5c4e7c4025b92c00",
                "shortShareUrl": "http://lu.kaola.com/52uV37"
            },
            "priceInfo": {
                "currentPrice": 50,
                "marketPrice": 200,
                "memberCurrentPrice": 50,
                "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

请求拒绝

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