shopee根据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）
响应参数
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
未知错误
否
手机扫一扫
移动阅读更方便
你可能感兴趣的文章