526互联

虾皮shopee根据ID取商品详情 API 返回值说明

发布时间 2023-07-17 15:29:49作者: 万邦Noah
​

 item_get-根据ID取商品详情  注册开通

shopee.item_get

公共参数

名称类型必须描述
key String 是 调用key（必须以GET方式拼接在URL中）
secret String 是 调用密钥
api_name String 是 API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache String 否 [yes,no]默认yes，将调用缓存的数据，速度比较快
result_type String 否 [json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang String 否 [cn,en,ru]翻译语言，默认cn简体中文
version String 否 API版本

请求参数

请求参数：num_iid=264070136/5637247041&country=.com.my

参数说明：num_iid:商品ID-country:网站后缀（.com.my;.vn;.ph）

响应参数

Version: Date:

名称类型必须示例值描述

num_iid

 Bigint 0 5637247041 宝贝ID

title

 String 0 Fashionable plus size womens dress 2020 new spring and summer dress was thin and thin and fat sister dress two-piece suit 宝贝标题

price

 Float 0 22.17 价格

orginal_price

 String 0 31.68 原价

num

 Int 0 3836 库存

detail_url

 String 0 https://shopee.com.my/product/264070136/5637247041 宝贝链接

pic_url

 String 0 https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a 宝贝图片

brand

 String 0 No Brand 品牌名称

favcount

 Int 0 2027  

desc

 String 0    

skus

 Mix 0 {"sku": [{"price": "39", "total_price": null, "orginal_price": "39.00", "properties": "0:0", "properties_name": "0:0:T-shirt+skirt:M 建议【42.5-50KG】", "quantity": "305", "sku_id": "3166598625985"}] 商品规格信息列表

has_discount

 String 0 true  

item_size

 String 0    

cid

 Int 0 16  

currency

 String 0 MYR  

size_chart

 String 0 https://cf.shopee.com.my/file/6105b7c64414c2012908bff679b9321d  

sales

 Int 0 138 销量

item_imgs

 Mix 0 [{ "url": "https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a"} 商品图片

discount

 String 0 30%  

location

 String 0 Mainland China 发货地

shop_id

 Int 0 151372205 店铺ID

seller_info

 Mix 0 {"nick": "qzq1274334183.my", "city": "Mainland China", "level": 12, "seller_promotion_refresh_time": "2021-01-19 02:00:00", "zhuy": "https://shopee.com.my/shop/264070136/search", "shop_type": "A"} 卖家信息

prop_imgs

 Mix 0 [] 属性图片

props_list

 Mix 0 {20509:9974422: 尺码:36} 商品属性

props_name

 String 0 0:0:T-shirt+skirt:M 建议【42.5-50KG】;0:1:T-shirt+skirt:L 建议 【50-57.5kg】; 商品属性名

props

 Mix 0 [{ "name": "产地","value": "中国" }] 商品详情

current_lang

 String 0 en  

currency_code

 String 0 MYR  

props_img

 Mix 0 1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg 属性图片

shop_item

 Mix 0 []  

relate_items

 Mix 0 []  

tmall

 Boolean 0 false 是否天猫

error

 String 0   错误信息

warning

 String 0 price_json error;skus miss; 警告信息

url_log

 Mix 0 []  

method

 String 0 item_tmall:pget_item  

promo_type

 String 0    

请求示例

-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/shopee/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=264070136/5637247041&country=.com.my"

响应示例

{
	"item": {
		"num_iid": 5637247041,
		"title": "Fashionable plus size women's dress 2020 new spring and summer dress was thin and thin and fat sister dress two-piece suit",
		"detail_url": "https://shopee.com.my/product/264070136/5637247041",
		"pic_url": "https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a",
		"price": 0.0003168,
		"orginal_price": 0.0003168,
		"cid": 100017,
		"desc": "Brand: Other/Other\nStyle: Sweet and Fresh/College\nPopular elements: buttons, gauze, stitching\nStyle: skirt suit\nsleeve length: short sleeve\nFabric/Material: Other/Polyester (Polyester Fiber)\nIngredient content: 71% (inclusive)-80% (inclusive)\nWhether to add cashmere: no cashmere\nTime to market: Spring 2020\nDelivery time：\nShipped on the same day before subscripting at 18:00 every day,\nIt is estimated that it will take 4-10 days for normal goods to arrive at your hands\n\nMasa penghantaran\nDihantar pada hari yang sama sebelum pukul 18:00 setiap hari\nDihantar keesokan harinya selepas jam 18:00.\nDianggarkan memerlukan masa 4-10 hari untuk barang biasa sampai tangan anda\n\nPakaian wanita bersaiz plus bergaya.Pakaian musim bunga dan musim panas dalam 2020 yang baru\nkurus dan gemuk itu berpakaian yg dua keping<img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.64b4eacf70353&p=1778786612&k=i_key&t=1689578192\" style=\"display:none\" />",
		"item_imgs": [
			{
				"url": "https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a"
			},
			{
				"url": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb"
			},
			{
				"url": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
			},
			{
				"url": "https://cf.shopee.com.my/file/35f35de0d5826c4969a42483b34d8bea"
			},
			{
				"url": "https://cf.shopee.com.my/file/14b7804a2a87c70fa763c518ce6ec583"
			},
			{
				"url": "https://cf.shopee.com.my/file/e1bc3fe36abc09c00ead17243b9825f0"
			},
			{
				"url": "https://cf.shopee.com.my/file/ab490d68394575366c36cee16ad0f86e"
			},
			{
				"url": "https://cf.shopee.com.my/file/a6148259a00b460f5e30ba04a327f9a3"
			},
			{
				"url": "https://cf.shopee.com.my/file/e1bc5d2bb3c010af4f688e6f22a63eca"
			}
		],
		"props": [
			{
				"name": "Plus Size",
				"value": "Yes"
			},
			{
				"name": "Dress/Skirt Length",
				"value": "Midi"
			}
		],
		"props_list": {
			"16657:16728": "颜色分类:T-shirt+skirt",
			"16657:17067": "颜色分类:T-shirt",
			"16657:17196": "颜色分类:skirt",
			"17278:17286": "尺码:M 建议【42.5-50KG】",
			"17278:17328": "尺码:L 建议 【50-57.5kg】",
			"17278:17388": "尺码:XL 【建议57.5-65kg】",
			"17278:17445": "尺码:2XL 【建议65-72.5kg】",
			"17278:17485": "尺码:3XL 【建议72.5-82.5kg】",
			"17278:17540": "尺码:4XL【建议82.5-90kg】"
		},
		"prop_imgs": {
			"prop_img": [
				{
					"properties": "16657:16728",
					"url": "https://cf.shopee.com.my/file/81bea46afa4113012b7330cc3c846428"
				},
				{
					"properties": "16657:17067",
					"url": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb"
				},
				{
					"properties": "16657:17196",
					"url": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
				}
			]
		},
		"props_imgs": {
			"prop_img": [
				{
					"properties": "16657:16728",
					"url": "https://cf.shopee.com.my/file/81bea46afa4113012b7330cc3c846428"
				},
				{
					"properties": "16657:17067",
					"url": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb"
				},
				{
					"properties": "16657:17196",
					"url": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
				}
			]
		},
		"props_name": "16657:16728:颜色分类:T-shirt+skirt;16657:16728:颜色分类:T-shirt+skirt;16657:16728:颜色分类:T-shirt+skirt;16657:16728:颜色分类:T-shirt+skirt;16657:16728:颜色分类:T-shirt+skirt;16657:16728:颜色分类:T-shirt+skirt;16657:17067:颜色分类:T-shirt;16657:17067:颜色分类:T-shirt;16657:17067:颜色分类:T-shirt;16657:17067:颜色分类:T-shirt;16657:17067:颜色分类:T-shirt;16657:17067:颜色分类:T-shirt;16657:17196:颜色分类:skirt;16657:17196:颜色分类:skirt;16657:17196:颜色分类:skirt;16657:17196:颜色分类:skirt;16657:17196:颜色分类:skirt;16657:17196:颜色分类:skirt;17278:17286:尺码:M 建议【42.5-50KG】;17278:17328:尺码:L 建议 【50-57.5kg】;17278:17388:尺码:XL 【建议57.5-65kg】;17278:17445:尺码:2XL 【建议65-72.5kg】;17278:17485:尺码:3XL 【建议72.5-82.5kg】;17278:17540:尺码:4XL【建议82.5-90kg】;17278:17286:尺码:M 建议【42.5-50KG】;17278:17328:尺码:L 建议 【50-57.5kg】;17278:17388:尺码:XL 【建议57.5-65kg】;17278:17445:尺码:2XL 【建议65-72.5kg】;17278:17485:尺码:3XL 【建议72.5-82.5kg】;17278:17540:尺码:4XL【建议82.5-90kg】;17278:17286:尺码:M 建议【42.5-50KG】;17278:17328:尺码:L 建议 【50-57.5kg】;17278:17388:尺码:XL 【建议57.5-65kg】;17278:17445:尺码:2XL 【建议65-72.5kg】;17278:17485:尺码:3XL 【建议72.5-82.5kg】;17278:17540:尺码:4XL【建议82.5-90kg】",
		"desc_img": [],
		"location": null,
		"post_fee": "",
		"skus": {
			"sku": [
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "16657:16728;17278:17286",
					"properties_name": "16657:16728:颜色分类:T-shirt+skirt;17278:17286:尺码:M 建议【42.5-50KG】",
					"quantity": 982,
					"sku_id": null
				},
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "16657:16728;17278:17328",
					"properties_name": "16657:16728:颜色分类:T-shirt+skirt;17278:17328:尺码:L 建议 【50-57.5kg】",
					"quantity": 983,
					"sku_id": null
				},
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "16657:16728;17278:17388",
					"properties_name": "16657:16728:颜色分类:T-shirt+skirt;17278:17388:尺码:XL 【建议57.5-65kg】",
					"quantity": 992,
					"sku_id": null
				},
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "16657:16728;17278:17445",
					"properties_name": "16657:16728:颜色分类:T-shirt+skirt;17278:17445:尺码:2XL 【建议65-72.5kg】",
					"quantity": 989,
					"sku_id": null
				},
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "16657:16728;17278:17485",
					"properties_name": "16657:16728:颜色分类:T-shirt+skirt;17278:17485:尺码:3XL 【建议72.5-82.5kg】",
					"quantity": 992,
					"sku_id": null
				},
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "16657:16728;17278:17540",
					"properties_name": "16657:16728:颜色分类:T-shirt+skirt;17278:17540:尺码:4XL【建议82.5-90kg】",
					"quantity": 985,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "16657:17067;17278:17286",
					"properties_name": "16657:17067:颜色分类:T-shirt;17278:17286:尺码:M 建议【42.5-50KG】",
					"quantity": 998,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "16657:17067;17278:17328",
					"properties_name": "16657:17067:颜色分类:T-shirt;17278:17328:尺码:L 建议 【50-57.5kg】",
					"quantity": 999,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "16657:17067;17278:17388",
					"properties_name": "16657:17067:颜色分类:T-shirt;17278:17388:尺码:XL 【建议57.5-65kg】",
					"quantity": 1000,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "16657:17067;17278:17445",
					"properties_name": "16657:17067:颜色分类:T-shirt;17278:17445:尺码:2XL 【建议65-72.5kg】",
					"quantity": 999,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "16657:17067;17278:17485",
					"properties_name": "16657:17067:颜色分类:T-shirt;17278:17485:尺码:3XL 【建议72.5-82.5kg】",
					"quantity": 999,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "16657:17067;17278:17540",
					"properties_name": "16657:17067:颜色分类:T-shirt;17278:17540:尺码:4XL【建议82.5-90kg】",
					"quantity": 998,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "16657:17196;17278:17286",
					"properties_name": "16657:17196:颜色分类:skirt;17278:17286:尺码:M 建议【42.5-50KG】",
					"quantity": 1000,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "16657:17196;17278:17328",
					"properties_name": "16657:17196:颜色分类:skirt;17278:17328:尺码:L 建议 【50-57.5kg】",
					"quantity": 1000,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "16657:17196;17278:17388",
					"properties_name": "16657:17196:颜色分类:skirt;17278:17388:尺码:XL 【建议57.5-65kg】",
					"quantity": 997,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "16657:17196;17278:17445",
					"properties_name": "16657:17196:颜色分类:skirt;17278:17445:尺码:2XL 【建议65-72.5kg】",
					"quantity": 998,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "16657:17196;17278:17485",
					"properties_name": "16657:17196:颜色分类:skirt;17278:17485:尺码:3XL 【建议72.5-82.5kg】",
					"quantity": 999,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "16657:17196;17278:17540",
					"properties_name": "16657:17196:颜色分类:skirt;17278:17540:尺码:4XL【建议82.5-90kg】",
					"quantity": 997,
					"sku_id": null
				}
			]
		},
		"num": 17907,
		"seller_id": null,
		"shop_id": "",
		"nick": null,
		"sales": 0,
		"total_sold": "-1",
		"seller_info": {
			"nick": null,
			"item_score": null,
			"score_p": null,
			"delivery_score": null,
			"shop_type": "",
			"user_num_id": null,
			"sid": "",
			"title": "",
			"zhuy": "https://my.xiapibuy.com/qzq1274334183.my",
			"cert": null,
			"open_time": "",
			"credit_score": null,
			"shop_name": "Big size women's fashion "
		},
		"data_from": "Ha",
		"props_img": {
			"16657:16728": "https://cf.shopee.com.my/file/81bea46afa4113012b7330cc3c846428",
			"16657:17067": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb",
			"16657:17196": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
		},
		"format_check": "ok",
		"shop_item": [],
		"relate_items": []
	},
	"error": "",
	"secache": "da67365cb819d7c288d8451ffd8c3692",
	"secache_time": 1689578192,
	"secache_date": "2023-07-17 15:16:32",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"reason": "",
	"error_code": "0000",

异常示例

{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "taobao",
  "request_id": "15ee0ffc041242"}


​