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 | 未知错误 | 否 |