商品详情API接口可以提供商品的基本信息,如名称、描述、价格、图片等,帮助电子商务平台展示和推荐商品。此外,还可以提供商品的库存信息、销售数据、评论信息等,帮助平台进行数据分析和管理。
shopee.item_get-根据ID获取取商品详情
公共参数
请求地址: 注册调用key请求接入
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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 | shopee.com.my/product/264... | 宝贝链接 |
pic_url | String | 0 | cf.shopee.com.my/file/f8bc11... | 宝贝图片 |
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 | cf.shopee.com.my/file/6105b7... | |
sales | Int | 0 | 138 | 销量 |
item_imgs | Mix | 0 | [{ "url": "cf.shopee.com.my/file/f8bc11..."} | 商品图片 |
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": "shopee.com.my/shop/264070...", "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 |
Java请求示例
java
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.net.URL;
import java.nio.charset.Charset;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.PrintWriter;
import java.net.URLConnection;
public class Example {
private static String readAll(Reader rd) throws IOException {
StringBuilder sb = new StringBuilder();
int cp;
while ((cp = rd.read()) != -1) {
sb.append((char) cp);
}
return sb.toString();
}
public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
conn.setDoOutput(true);
conn.setDoInput(true);
PrintWriter out = new PrintWriter(conn.getOutputStream());
out.print(body);
out.flush();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static void main(String[] args) throws IOException, JSONException {
// 请求示例 url 默认请求参数已经URL编码处理
String url = "https://shopee/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=264070136/5637247041&country=.com.my";
JSONObject json = getRequestFromUrl(url);
System.out.println(json.toString());
}
}
响应示例
swift
{
"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": 22.18,
"orginal_price": 31.68,
"num": 17907,
"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-4.6531ed5256d51&p=1778787569&k=i_key&t=1697770837" style="display:none" />",
"skus": {
"sku": [
{
"price": 22.18,
"orginal_price": 31.68,
"properties": "2:3",
"properties_name": "2:3:skirt:2XL 【建议65-72.5kg】",
"quantity": 998,
"sku_id": 19329148701
},
{
"price": 44.36,
"orginal_price": 63.36,
"properties": "0:5",
"properties_name": "0:5:T-shirt+skirt:4XL【建议82.5-90kg】",
"quantity": 985,
"sku_id": 19329148691
},
{
"price": 22.18,
"orginal_price": 31.68,
"properties": "2:4",
"properties_name": "2:4:skirt:3XL 【建议72.5-82.5kg】",
"quantity": 999,
"sku_id": 19329148702
},
{
"price": 44.36,
"orginal_price": 63.36,
"properties": "0:2",
"properties_name": "0:2:T-shirt+skirt:XL 【建议57.5-65kg】",
"quantity": 992,
"sku_id": 19329148688
},
{
"price": 44.36,
"orginal_price": 63.36,
"properties": "0:3",
"properties_name": "0:3:T-shirt+skirt:2XL 【建议65-72.5kg】",
"quantity": 989,
"sku_id": 19329148689
},
{
"price": 44.36,
"orginal_price": 63.36,
"properties": "0:1",
"properties_name": "0:1:T-shirt+skirt:L 建议 【50-57.5kg】",
"quantity": 983,
"sku_id": 19329148687
},
{
"price": 22.18,
"orginal_price": 31.68,
"properties": "2:5",
"properties_name": "2:5:skirt:4XL【建议82.5-90kg】",
"quantity": 997,
"sku_id": 19329148703
},
{
"price": 26.66,
"orginal_price": 38.08,
"properties": "1:4",
"properties_name": "1:4:T-shirt:3XL 【建议72.5-82.5kg】",
"quantity": 999,
"sku_id": 19329148696
},
{
"price": 26.66,
"orginal_price": 38.08,
"properties": "1:3",
"properties_name": "1:3:T-shirt:2XL 【建议65-72.5kg】",
"quantity": 999,
"sku_id": 19329148695
},
{
"price": 26.66,
"orginal_price": 38.08,
"properties": "1:5",
"properties_name": "1:5:T-shirt:4XL【建议82.5-90kg】",
"quantity": 998,
"sku_id": 19329148697
},
{
"price": 44.36,
"orginal_price": 63.36,
"properties": "0:4",
"properties_name": "0:4:T-shirt+skirt:3XL 【建议72.5-82.5kg】",
"quantity": 992,
"sku_id": 19329148690
},
{
"price": 22.18,
"orginal_price": 31.68,
"properties": "2:1",
"properties_name": "2:1:skirt:L 建议 【50-57.5kg】",
"quantity": 1000,
"sku_id": 19329148699
},
{
"price": 22.18,
"orginal_price": 31.68,
"properties": "2:0",
"properties_name": "2:0:skirt:M 建议【42.5-50KG】",
"quantity": 1000,
"sku_id": 19329148698
},
{
"price": 44.36,
"orginal_price": 63.36,
"properties": "0:0",
"properties_name": "0:0:T-shirt+skirt:M 建议【42.5-50KG】",
"quantity": 982,
"sku_id": 19329148686
},
{
"price": 26.66,
"orginal_price": 38.08,
"properties": "1:0",
"properties_name": "1:0:T-shirt:M 建议【42.5-50KG】",
"quantity": 998,
"sku_id": 19329148692
},
{
"price": 22.18,
"orginal_price": 31.68,
"properties": "2:2",
"properties_name": "2:2:skirt:XL 【建议57.5-65kg】",
"quantity": 997,
"sku_id": 19329148700
},
{
"price": 26.66,
"orginal_price": 38.08,
"properties": "1:2",
"properties_name": "1:2:T-shirt:XL 【建议57.5-65kg】",
"quantity": 1000,
"sku_id": 19329148694
},
{
"price": 26.66,
"orginal_price": 38.08,
"properties": "1:1",
"properties_name": "1:1:T-shirt:L 建议 【50-57.5kg】",
"quantity": 999,
"sku_id": 19329148693
}
]
},
"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": 337,
"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",
"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": {
"2:3": "skirt:2XL 【建议65-72.5kg】",
"0:5": "T-shirt+skirt:4XL【建议82.5-90kg】",
"2:4": "skirt:3XL 【建议72.5-82.5kg】",
"0:2": "T-shirt+skirt:XL 【建议57.5-65kg】",
"0:3": "T-shirt+skirt:2XL 【建议65-72.5kg】",
"0:1": "T-shirt+skirt:L 建议 【50-57.5kg】",
"2:5": "skirt:4XL【建议82.5-90kg】",
"1:4": "T-shirt:3XL 【建议72.5-82.5kg】",
"1:3": "T-shirt:2XL 【建议65-72.5kg】",
"1:5": "T-shirt:4XL【建议82.5-90kg】",
"0:4": "T-shirt+skirt:3XL 【建议72.5-82.5kg】",
"2:1": "skirt:L 建议 【50-57.5kg】",
"2:0": "skirt:M 建议【42.5-50KG】",
"0:0": "T-shirt+skirt:M 建议【42.5-50KG】",
"1:0": "T-shirt:M 建议【42.5-50KG】",
"2:2": "skirt:XL 【建议57.5-65kg】",
"1:2": "T-shirt:XL 【建议57.5-65kg】",
"1:1": "T-shirt:L 建议 【50-57.5kg】"
},
"_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": []
},
"error": "",
"secache": "da67365cb819d7c288d8451ffd8c3692",
"secache_time": 1697770837,
"secache_date": "2023-10-20 11:00:37",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:53 max:10100 all[142=53+18+71];expires:2030-12-31",
"execution_time": "3.138",
"server_time": "Beijing/2023-10-20 11:00:37",
"client_ip": "106.6.36.241",
"call_args": {
"num_iid": "264070136/5637247041",
"is_promotion": ".com.my"
},
"api_type": "shopee",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "0.81MB",
"request_id": "gw-4.6531ed5256d51",
"last_id": "2205249143"
}