虾皮Shopee作为全球知名的电商平台,其API为开发者提供了丰富的数据接口。当商家或开发者通过Shopee API查询商品详情时,会收到一份详尽的返回值。这份返回值是商品信息的数字化呈现,包含了商品的ID、标题、价格、库存、描述、图片链接以及规格参数等重要数据。通过全面解析这些返回值,商家能够精准地了解商品在平台上的展示状态,而开发者则能够基于这些数据构建出更加智能、个性化的电商应用。在竞争激烈的电商市场中,充分利用Shopee API商品详情返回值,将成为提升商品竞争力、优化用户体验的关键一环。
虾皮(Shopee)的API商品详情返回值是商家和开发者在调用商品详情API接口时,从Shopee平台获取到的关于特定商品的详细信息。这些信息对于商品展示、比价、推荐等场景非常重要。下面是对虾皮Shopee API商品详情返回值的全面解析:
一、返回值概述
虾皮Shopee API商品详情返回值通常包含商品的多个属性,包括但不限于:
- 商品ID:唯一标识商品的编号。
- 商品标题:商品的名称或描述性标题。
- 商品价格:商品的售价,可能包含原价、折扣价等信息。
- 商品库存:商品的库存数量,表示当前可售卖的数量。
- 商品描述:对商品的详细描述,可能包含材质、尺寸、功能等信息。
- 商品图片:商品的图片链接,用于展示商品外观。
- 商品规格参数:商品的详细规格参数,如颜色、尺寸、重量等。
虾皮shopee根据ID取商品详情 API
item_get-根据ID取商品详情 [查看演示] API测试工具 注册开通
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)
返回数据示例
"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",
"price": 34.85,
"orginal_price": 0,
"num": 17903,
"detail_url": "https://shopee.com.my/jewellery-emas-cop-916-gold-bracelet-elet-gold-bracelet-gelang-tangan-bracelets-charms-cute-bracelet-emas-korea-i.264070136.5637247041?",
"pic_url": "https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a",
"brand": null,
"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.6638370c34ad4&p=1778787245&k=i_key&t=1714960142\" style=\"display:none\" />",
"skus": {
"sku": [
{
"price": 41.89,
"orginal_price": 0,
"properties": "1:5",
"properties_name": "1:5:T-shirt:4XL【建议82.5-90kg】",
"quantity": 998,
"sku_id": 19329148697
},
{
"price": 34.85,
"orginal_price": 0,
"properties": "2:1",
"properties_name": "2:1:skirt:L 建议 【50-57.5kg】",
"quantity": 999,
"sku_id": 19329148699
},
{
"price": 41.89,
"orginal_price": 0,
"properties": "1:3",
"properties_name": "1:3:T-shirt:2XL 【建议65-72.5kg】",
"quantity": 999,
"sku_id": 19329148695
},
{
"price": 34.85,
"orginal_price": 0,
"properties": "2:5",
"properties_name": "2:5:skirt:4XL【建议82.5-90kg】",
"quantity": 997,
"sku_id": 19329148703
},
{
"price": 69.7,
"orginal_price": 0,
"properties": "0:4",
"properties_name": "0:4:T-shirt+skirt:3XL 【建议72.5-82.5kg】",
"quantity": 992,
"sku_id": 19329148690
},
{
"price": 69.7,
"orginal_price": 0,
"properties": "0:5",
"properties_name": "0:5:T-shirt+skirt:4XL【建议82.5-90kg】",
"quantity": 985,
"sku_id": 19329148691
},
{
"price": 34.85,
"orginal_price": 0,
"properties": "2:0",
"properties_name": "2:0:skirt:M 建议【42.5-50KG】",
"quantity": 1000,
"sku_id": 19329148698
},
{
"price": 41.89,
"orginal_price": 0,
"properties": "1:0",
"properties_name": "1:0:T-shirt:M 建议【42.5-50KG】",
"quantity": 998,
"sku_id": 19329148692
},
{
"price": 69.7,
"orginal_price": 0,
"properties": "0:3",
"properties_name": "0:3:T-shirt+skirt:2XL 【建议65-72.5kg】",
"quantity": 989,
"sku_id": 19329148689
},
{
"price": 41.89,
"orginal_price": 0,
"properties": "1:1",
"properties_name": "1:1:T-shirt:L 建议 【50-57.5kg】",
"quantity": 999,
"sku_id": 19329148693
},
{
"price": 34.85,
"orginal_price": 0,
"properties": "2:4",
"properties_name": "2:4:skirt:3XL 【建议72.5-82.5kg】",
"quantity": 999,
"sku_id": 19329148702
},
{
"price": 69.7,
"orginal_price": 0,
"properties": "0:0",
"properties_name": "0:0:T-shirt+skirt:M 建议【42.5-50KG】",
"quantity": 982,
"sku_id": 19329148686
},
{
"price": 69.7,
"orginal_price": 0,
"properties": "0:2",
"properties_name": "0:2:T-shirt+skirt:XL 【建议57.5-65kg】",
"quantity": 992,
"sku_id": 19329148688
},
{
"price": 41.89,
"orginal_price": 0,
"properties": "1:4",
"properties_name": "1:4:T-shirt:3XL 【建议72.5-82.5kg】",
"quantity": 998,
"sku_id": 19329148696
},
{
"price": 34.85,
"orginal_price": 0,
"properties": "2:2",
"properties_name": "2:2:skirt:XL 【建议57.5-65kg】",
"quantity": 996,
"sku_id": 19329148700
},
{
"price": 34.85,
"orginal_price": 0,
"properties": "2:3",
"properties_name": "2:3:skirt:2XL 【建议65-72.5kg】",
"quantity": 998,
"sku_id": 19329148701
},
{
"price": 69.7,
"orginal_price": 0,
"properties": "0:1",
"properties_name": "0:1:T-shirt+skirt:L 建议 【50-57.5kg】",
"quantity": 982,
"sku_id": 19329148687
},
{
"price": 41.89,
"orginal_price": 0,
"properties": "1:2",
"properties_name": "1:2:T-shirt:XL 【建议57.5-65kg】",
"quantity": 1000,
"sku_id": 19329148694
}
]
},
"has_discount": "false",
"item_size": [
"T-shirt+skirt",
"T-shirt",
"skirt"
],
"cid": 100017,
"categories": [
{
"catid": 100017,
"display_name": "Women Clothes",
"is_default_subcat": false,
"no_sub": false
},
{
"catid": 100104,
"display_name": "Dresses",
"is_default_subcat": false,
"no_sub": true
}
],
"currency": "MYR",
"sales": 341,
"item_imgs": {
"item_img": [
{
"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"
}
]
},
"location": "Mainland China",
"liked_count": 3172,
"rating_star": "4.91",
"shop_id": 264070136,
"prop_imgs": {
"prop_img": [
{
"properties": "0:0",
"url": "https://cf.shopee.com.my/file/81bea46afa4113012b7330cc3c846428"
},
{
"properties": "0:1",
"url": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb"
},
{
"properties": "0:2",
"url": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
}
]
},
"props_list": {
"0:0": "颜色分类:T-shirt+skirt",
"0:1": "颜色分类:T-shirt",
"0:2": "颜色分类:skirt",
"1:0": "尺码:M 建议【42.5-50KG】",
"1:1": "尺码:L 建议 【50-57.5kg】",
"1:2": "尺码:XL 【建议57.5-65kg】",
"1:3": "尺码:2XL 【建议65-72.5kg】",
"1:4": "尺码:3XL 【建议72.5-82.5kg】",
"1:5": "尺码:4XL【建议82.5-90kg】"
},
"_ddf": "boy",
"props_img": {
"0:0": "https://cf.shopee.com.my/file/81bea46afa4113012b7330cc3c846428",
"0:1": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb",
"0:2": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
},
"format_check": "ok",
"desc_img": [],
"shop_item": [],
"relate_items": []
二、返回值字段详解
以下是对一些常见返回值字段的详细解释:
- 商品ID(item_id):唯一标识商品的编号,通常由数字和字母组成。商家和开发者可以通过商品ID来查找和识别商品。
- 商品标题(title):商品的名称或描述性标题,用于展示商品的名称和特性。商家和开发者可以将商品标题用于商品展示和搜索。
- 商品价格(price):商品的售价,通常以货币单位表示。价格可能包含原价、折扣价等信息,商家和开发者可以根据价格信息进行价格比较和调整。
- 商品库存(stock_quantity):商品的库存数量,表示当前可售卖的数量。商家和开发者可以根据库存信息来决定是否继续进货或进行促销活动。
- 商品描述(description):对商品的详细描述,可能包含材质、尺寸、功能等信息。商家和开发者可以将商品描述用于商品展示和介绍,帮助消费者更好地了解商品。
- 商品图片(image_urls):商品的图片链接,用于展示商品外观。商家和开发者可以将图片链接用于商品展示和推荐,提高商品的吸引力和购买率。
- 商品规格参数(attributes):商品的详细规格参数,如颜色、尺寸、重量等。商家和开发者可以根据规格参数来筛选和推荐符合消费者需求的商品。
三、注意事项
- 返回值字段可能因API版本和地区而有所不同,商家和开发者在调用API接口时需要参考最新的API文档。
- 商家和开发者在获取和使用商品详情返回值时,需要遵守虾皮Shopee平台的相关规定和政策,确保合法合规地使用数据。
- 商家和开发者可以通过虾皮Shopee开发者平台注册账号并创建应用来获取API调用凭证,以便调用商品详情API接口并获取商品详情返回值。