526互联

shopee根据ID取商品详情 API

发布时间 2023-07-19 16:06:28作者: 万邦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-3.64b797ca9de58&p=1778786612&k=i_key&t=1689753547\" 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": {
			"44732:44792": "颜色分类:T-shirt+skirt",
			"44732:45177": "颜色分类:T-shirt",
			"44732:45247": "颜色分类:skirt",
			"45327:45335": "尺码:M 建议【42.5-50KG】",
			"45327:45397": "尺码:L 建议 【50-57.5kg】",
			"45327:45440": "尺码:XL 【建议57.5-65kg】",
			"45327:45500": "尺码:2XL 【建议65-72.5kg】",
			"45327:45541": "尺码:3XL 【建议72.5-82.5kg】",
			"45327:45601": "尺码:4XL【建议82.5-90kg】"
		},
		"prop_imgs": {
			"prop_img": [
				{
					"properties": "44732:44792",
					"url": "https://cf.shopee.com.my/file/81bea46afa4113012b7330cc3c846428"
				},
				{
					"properties": "44732:45177",
					"url": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb"
				},
				{
					"properties": "44732:45247",
					"url": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
				}
			]
		},
		"props_imgs": {
			"prop_img": [
				{
					"properties": "44732:44792",
					"url": "https://cf.shopee.com.my/file/81bea46afa4113012b7330cc3c846428"
				},
				{
					"properties": "44732:45177",
					"url": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb"
				},
				{
					"properties": "44732:45247",
					"url": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
				}
			]
		},
		"props_name": "44732:44792:颜色分类:T-shirt+skirt;44732:44792:颜色分类:T-shirt+skirt;44732:44792:颜色分类:T-shirt+skirt;44732:44792:颜色分类:T-shirt+skirt;44732:44792:颜色分类:T-shirt+skirt;44732:44792:颜色分类:T-shirt+skirt;44732:45177:颜色分类:T-shirt;44732:45177:颜色分类:T-shirt;44732:45177:颜色分类:T-shirt;44732:45177:颜色分类:T-shirt;44732:45177:颜色分类:T-shirt;44732:45177:颜色分类:T-shirt;44732:45247:颜色分类:skirt;44732:45247:颜色分类:skirt;44732:45247:颜色分类:skirt;44732:45247:颜色分类:skirt;44732:45247:颜色分类:skirt;44732:45247:颜色分类:skirt;45327:45335:尺码:M 建议【42.5-50KG】;45327:45397:尺码:L 建议 【50-57.5kg】;45327:45440:尺码:XL 【建议57.5-65kg】;45327:45500:尺码:2XL 【建议65-72.5kg】;45327:45541:尺码:3XL 【建议72.5-82.5kg】;45327:45601:尺码:4XL【建议82.5-90kg】;45327:45335:尺码:M 建议【42.5-50KG】;45327:45397:尺码:L 建议 【50-57.5kg】;45327:45440:尺码:XL 【建议57.5-65kg】;45327:45500:尺码:2XL 【建议65-72.5kg】;45327:45541:尺码:3XL 【建议72.5-82.5kg】;45327:45601:尺码:4XL【建议82.5-90kg】;45327:45335:尺码:M 建议【42.5-50KG】;45327:45397:尺码:L 建议 【50-57.5kg】;45327:45440:尺码:XL 【建议57.5-65kg】;45327:45500:尺码:2XL 【建议65-72.5kg】;45327:45541:尺码:3XL 【建议72.5-82.5kg】;45327:45601:尺码:4XL【建议82.5-90kg】",
		"desc_img": [],
		"location": null,
		"post_fee": "",
		"skus": {
			"sku": [
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "44732:44792;45327:45335",
					"properties_name": "44732:44792:颜色分类:T-shirt+skirt;45327:45335:尺码:M 建议【42.5-50KG】",
					"quantity": 982,
					"sku_id": null
				},
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "44732:44792;45327:45397",
					"properties_name": "44732:44792:颜色分类:T-shirt+skirt;45327:45397:尺码:L 建议 【50-57.5kg】",
					"quantity": 983,
					"sku_id": null
				},
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "44732:44792;45327:45440",
					"properties_name": "44732:44792:颜色分类:T-shirt+skirt;45327:45440:尺码:XL 【建议57.5-65kg】",
					"quantity": 992,
					"sku_id": null
				},
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "44732:44792;45327:45500",
					"properties_name": "44732:44792:颜色分类:T-shirt+skirt;45327:45500:尺码:2XL 【建议65-72.5kg】",
					"quantity": 989,
					"sku_id": null
				},
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "44732:44792;45327:45541",
					"properties_name": "44732:44792:颜色分类:T-shirt+skirt;45327:45541:尺码:3XL 【建议72.5-82.5kg】",
					"quantity": 992,
					"sku_id": null
				},
				{
					"price": 0.0006336,
					"total_price": 0,
					"orginal_price": 0.0006336,
					"properties": "44732:44792;45327:45601",
					"properties_name": "44732:44792:颜色分类:T-shirt+skirt;45327:45601:尺码:4XL【建议82.5-90kg】",
					"quantity": 985,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "44732:45177;45327:45335",
					"properties_name": "44732:45177:颜色分类:T-shirt;45327:45335:尺码:M 建议【42.5-50KG】",
					"quantity": 998,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "44732:45177;45327:45397",
					"properties_name": "44732:45177:颜色分类:T-shirt;45327:45397:尺码:L 建议 【50-57.5kg】",
					"quantity": 999,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "44732:45177;45327:45440",
					"properties_name": "44732:45177:颜色分类:T-shirt;45327:45440:尺码:XL 【建议57.5-65kg】",
					"quantity": 1000,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "44732:45177;45327:45500",
					"properties_name": "44732:45177:颜色分类:T-shirt;45327:45500:尺码:2XL 【建议65-72.5kg】",
					"quantity": 999,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "44732:45177;45327:45541",
					"properties_name": "44732:45177:颜色分类:T-shirt;45327:45541:尺码:3XL 【建议72.5-82.5kg】",
					"quantity": 999,
					"sku_id": null
				},
				{
					"price": 0.0003808,
					"total_price": 0,
					"orginal_price": 0.0003808,
					"properties": "44732:45177;45327:45601",
					"properties_name": "44732:45177:颜色分类:T-shirt;45327:45601:尺码:4XL【建议82.5-90kg】",
					"quantity": 998,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "44732:45247;45327:45335",
					"properties_name": "44732:45247:颜色分类:skirt;45327:45335:尺码:M 建议【42.5-50KG】",
					"quantity": 1000,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "44732:45247;45327:45397",
					"properties_name": "44732:45247:颜色分类:skirt;45327:45397:尺码:L 建议 【50-57.5kg】",
					"quantity": 1000,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "44732:45247;45327:45440",
					"properties_name": "44732:45247:颜色分类:skirt;45327:45440:尺码:XL 【建议57.5-65kg】",
					"quantity": 997,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "44732:45247;45327:45500",
					"properties_name": "44732:45247:颜色分类:skirt;45327:45500:尺码:2XL 【建议65-72.5kg】",
					"quantity": 998,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "44732:45247;45327:45541",
					"properties_name": "44732:45247:颜色分类:skirt;45327:45541:尺码:3XL 【建议72.5-82.5kg】",
					"quantity": 999,
					"sku_id": null
				},
				{
					"price": 0.0003168,
					"total_price": 0,
					"orginal_price": 0.0003168,
					"properties": "44732:45247;45327:45601",
					"properties_name": "44732:45247:颜色分类:skirt;45327:45601:尺码: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": {
			"44732:44792": "https://cf.shopee.com.my/file/81bea46afa4113012b7330cc3c846428",
			"44732:45177": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb",
			"44732:45247": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
		},
		"format_check": "ok",
		"shop_item": [],
		"relate_items": []
	},
	"error": "",
	"secache": "da67365cb819d7c288d8451ffd8c3692",
	"secache_time": 1689753547,
	"secache_date": "2023-07-19 15:59:07",
	"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"}

错误码解释

状态代码(error_code)状态信息详细描述是否收费
0000 success 接口调用成功并返回相关数据 是
2000 Search success but no result 接口访问成功，但是搜索没有结果 是
4000 Server internal error 服务器内部错误 否
4001 Network error 网络错误 否
4002 Target server error 目标服务器错误 否
4003 Param error 用户输入参数错误 忽略
4004 Account not found 用户帐号不存在 忽略
4005 Invalid authentication credentials 授权失败 忽略
4006 API stopped 您的当前API已停用 忽略
4007 Account stopped 您的账户已停用 忽略
4008 API rate limit exceeded 并发已达上限 忽略
4009 API maintenance API维护中 忽略
4010 API not found with these values API不存在 忽略
4012 Please add api first 请先添加api 忽略
4013 Number of calls exceeded 调用次数超限 忽略
4014 Missing url param 参数缺失 忽略
4015 Wrong pageToken 参数pageToken有误 忽略
4016 Insufficient balance 余额不足 忽略
4017 timeout error 请求超时 否
5000 unknown error 未知错误 否
​