淘宝商品详情API接口说明
淘宝商品详情API接口主要用于获取淘宝或天猫全网的商品详情页里面的商品信息,如:商品主图、价格、标题、sku等等。
API接口调用说明
接口名称:查询商品承若
接口状态:已完成
接口地址:http://gjx.sd1118.com/api/product/engage
请求方式:POST
Content-Type:Text
更新时间:2023-06-13 23:48:32
调用参数:
token |
string |
是 |
认证秘钥;个人中心获取。 |
个人中心获取 |
productId |
string |
是 |
淘宝商品ID,纯数字。请勿传入商品链接。 |
612657710561 |
一、商品承诺API
返回示例:
{
"msg": "该商品有承若!",
"code": 99,
"data": {
"engage": [
{
"title": "7天无理由退货",
"desc": "商品满足相应条件时(未使用、未洗涤、吊牌包装完整等),可申请“无理由退货”"
},
{
"title": "全场包邮",
"desc": "所有商品包邮(大陆偏远地区、港澳台及海外地区除外)"
}
],
"pay_money": 333
},
"state": true
}
响应参数:
data.engage |
array |
承若列表 |
data.pay_money |
number |
实际支付金额 |
code |
number |
当 state=true 并且 code=66 说明该商品没有承若。照样收费 |
二、商品详情基础版
详细说明:
注意! 不支持商品链接 只支持 商品ID 纯数字
返回示例:
{
"data": {
"defPrice": "19.8",
"shopLogo": null,
"productId": "626758342750",
"categoryId": null,
"shopId": "63442770",
"shopName": "窝牛旗舰店",
"productTitle": "墙纸自粘卧室温馨墙贴画防水防潮客厅背景墙房间壁纸家用装饰贴纸",
"productImg": "http://gw3.alicdn.com/tfscom/tuitui/i1/606955037/O1CN01jogC5K1n4zbnePyXI_!!606955037-0-lubanu-s.jpg",
"sellerId": "606955037",
"rootCategoryId": null,
"brandId": null,
"shopWw": "窝牛旗舰店",
"shopType": "B"
},
"code": 0,
"state": true,
"msg": "success"
}
响应参数:
data.productTitle |
string |
商品标题 |
data.productId |
string |
商品ID |
data.sellerId |
string |
卖家ID |
data.productImg |
string |
商品主图 |
data.shopName |
string |
店铺名称 |
data.shopId |
string |
店铺ID |
data.shopWw |
string |
掌柜旺旺 |
data.categoryId |
string |
分类ID |
data.defPrice |
string |
商品价格 |
data.shopLogo |
string |
店铺LOGO |
data.shopType |
string |
店铺类型 |
三、商品详情完全版
详细说明:
这个接口可能会被风控,如果返回结果错误,重新请求一次即可!
返回示例:
注:当最外层的state = false的时候则算接口失败,msg返回具体失败原因并不计算次数。
{
"msg": "success",
"code": 0,
"data": {
"seller": {
"shopCard": "本店共56件宝贝在热卖",
"shopName": "JBL耳机旗舰店",
"evaluates": [
{
"score": "4.8 ",
"tmallLevelTextColor": "#999999",
"level": "1",
"levelText": "高",
"levelBackgroundColor": "#EEEEEE",
"levelTextColor": "#999999",
"title": "宝贝描述",
"type": "desc",
"tmallLevelBackgroundColor": "#EEEEEE"
},
{
"score": "4.8 ",
"tmallLevelTextColor": "#999999",
"level": "1",
"levelText": "高",
"levelBackgroundColor": "#EEEEEE",
"levelTextColor": "#999999",
"title": "卖家服务",
"type": "serv",
"tmallLevelBackgroundColor": "#EEEEEE"
},
{
"score": "4.8 ",
"tmallLevelTextColor": "#999999",
"level": "1",
"levelText": "高",
"levelBackgroundColor": "#EEEEEE",
"levelTextColor": "#999999",
"title": "物流服务",
"type": "post",
"tmallLevelBackgroundColor": "#EEEEEE"
}
],
"entranceList": [
{
"borderColor": "#59ffffff",
"backgroundColor": "#59000000",
"action": [
{
"params": {
"url": "//shop.m.taobao.com/shop/shop_index.htm?user_id=2210501791540&item_id=663642903198¤tClickTime=-1"
},
"key": "open_url"
},
{
"params": {
"trackParams": {
"spm": "a.2141.7631564.shoppage"
},
"trackName": "Button-NewShopcard-ShopPage"
},
"key": "user_track"
}
],
"text": "进店逛逛",
"textColor": "#ffffff"
},
{
"borderColor": "#59ffffff",
"backgroundColor": "#59000000",
"action": [
{
"params": {
"url": "//shop.m.taobao.com/shop/shop_index.htm?user_id=2210501791540&item_id=663642903198&shop_navi=allitems"
},
"key": "open_url"
},
{
"params": {
"trackParams": {
"spm": "a.2141.7631564.allitem"
},
"trackName": "Button-NewShopcard-AllItem"
},
"key": "user_track"
}
],
"text": "全部宝贝",
"textColor": "#ffffff"
}
],
"showShopLinkIcon": false,
"simpleShopDOStatus": "1",
"fbt2User": "jbl耳机旗舰店",
"taoShopUrl": "//shop.m.taobao.com/shop/shop_index.htm?user_id=2210501791540&item_id=663642903198",
"creditLevel": "12",
"evaluates2": [
{
"score": "4.8 ",
"titleColor": "#ffffff",
"level": "1",
"scoreTextColor": "#ffffff",
"levelText": "高",
"levelTextColor": "#f0f0f0",
"title": "宝贝描述",
"type": "desc"
},
{
"score": "4.8 ",
"titleColor": "#ffffff",
"level": "1",
"scoreTextColor": "#ffffff",
"levelText": "高",
"levelTextColor": "#f0f0f0",
"title": "卖家服务",
"type": "serv"
},
{
"score": "4.8 ",
"titleColor": "#ffffff",
"level": "1",
"scoreTextColor": "#ffffff",
"levelText": "高",
"levelTextColor": "#f0f0f0",
"title": "物流服务",
"type": "post"
}
],
"atmosphereMaskColor": "#59000000",
"allItemCount": "56",
"creditLevelIcon": "//gw.alicdn.com/tfs/TB1QoJUIwmTBuNjy1XbXXaMrVXa-84-36.png?getAvatar=avatar",
"atmosphereColor": "#ffffff",
"shopId": "466989580",
"starts": "2021-01-26 23:16:31",
"brandIconRatio": "7.3",
"sellerNick": "jbl耳机旗舰店",
"goodRatePercentage": "100.00%",
"shopIcon": "//img.alicdn.com/imgextra//i3/6000000002059/O1CN01x4lr311R549msl0kJ_!!6000000002059-1-shopmanager.gif",
"shopUrl": "tmall://page.tm/shop?item_id=663642903198&shopId=466989580",
"userId": "2210501791540",
"brandIcon": "//gw.alicdn.com/tfs/TB10YPrjbj1gK0jSZFOXXc7GpXa-368-52.png?getAvatar=avatar",
"shopVersion": "0",
"fans": "13.9万",
"atmophereMask": true,
"atmosphereImg": "https://img.alicdn.com/imgextra/i3/2210501791540/O1CN01kkstuh1NFMdtlZH7Z_!!2210501791540.jpg",
"shopType": "B",
"sellerType": "B",
"shopTextColor": "#ffffff"
},
"propsCut": "品牌 型号 耳机材质 蓝牙版本 颜色分类 套餐类型 生产企业 耳机类别 防水性能 使用方式 保修期 防尘性能 ",
"item": {
"images": [
"//img.alicdn.com/imgextra/i4/2210501791540/O1CN01F8KSxQ1NFMgHeIKVV_!!2210501791540.jpg",
"//img.alicdn.com/imgextra/i4/2210501791540/O1CN01BZzZp51NFMfggAxT4_!!2210501791540.jpg",
"//img.alicdn.com/imgextra/i2/221050179