
taobao.item.get(淘宝 TOP 开放平台标准商品详情接口)app_key + app_secret 按 ASCII 升序生成签名 sign,携带 timestamp 时间戳防重放method:固定 taobao.item.getnum_iid:商品数字 ID(必填)fields:指定需要返回的字段(必填,按需拉取减少配额消耗)传入商品num_iid,可获取商品标题、类目、原价 / 促销价、主图详情图、多规格 SKU、库存、发货地、商家信息、商品参数、卖点、详情 HTML 等全量商品结构化数据,是电商比价、竞品监控、ERP 铺货、选品分析的核心接口。
{
"item_get_response": {
"code": 0,
"msg": "success",
"request_id": "req_202607031120009966",
"item": {
"num_iid": "689235711245",
"title": "2026夏季纯棉短袖女宽松百搭纯色基础T恤",
"nick": "简禾服饰旗舰店",
"cid": 16234,
"category_name": "女装 > T恤",
"type": "fixed",
"price": "79.90",
"promotion_price": "59.00",
"has_discount": true,
"location": "浙江杭州",
"express_fee": "0.00",
"sell_point": "100%纯棉面料,不起球不褪色,多色可选",
"pic_url": "https://img.alicdn.com/imgextra/i1/O1CN01a12345.jpg",
"item_imgs": [
{
"url": "https://img.alicdn.com/imgextra/i1/O1CN01a12345.jpg"
},
{
"url": "https://img.alicdn.com/imgextra/i1/O1CN01a67890.jpg"
}
],
"desc": "<p>100%精梳纯棉,透气吸汗,日常通勤百搭,多种尺码颜色可选...</p>",
"skus": [
{
"sku_id": "123456789001",
"properties": "颜色:白色;尺码:M",
"price": "59.00",
"stock": 180,
"sku_img": "https://img.alicdn.com/imgextra/i1/white_m.jpg"
},
{
"sku_id": "123456789002",
"properties": "颜色:黑色;尺码:XL",
"price": "59.00",
"stock": 125,
"sku_img": "https://img.alicdn.com/imgextra/i1/black_xl.jpg"
}
],
"props_list": [
{
"name": "面料",
"value": "100%纯棉"
},
{
"name": "版型",
"value": "宽松常规"
},
{
"name": "适用季节",
"value": "夏季"
}
],
"total_stock": 460,
"detail_url": "https://item.taobao.com/item.htm?id=689235711245"
}
}
}{
"item_get_response": {
"code": 15,
"msg": "Invalid signature",
"request_id": "req_202607031122001234",
"error_response": {
"sub_code": "isv.invalid-sign",
"sub_msg": "检查AppSecret、参数排序、服务器时间"
}
}
}{
"item_get_response": {
"code": 11,
"msg": "Insufficient permissions",
"request_id": "req_202607031123005678",
"error_response": {
"sub_code": "isv.api-no-auth",
"sub_msg": "未申请taobao.item.get接口权限或字段越权"
}
}
}{
"item_get_response": {
"code": 27,
"msg": "item not found",
"request_id": "req_202607031124009012",
"item": null
}
}{
"item_get_response": {
"code": 7,
"msg": "App Call Limited",
"request_id": "req_202607031125003456",
"error_response": {
"sub_msg": "请求频次超出限制,请增加调用间隔"
}
}
}{
"item_get_response": {
"code": 40,
"msg": "Missing required parameter num_iid",
"request_id": "req_202607031126007890"
}
}item_get_response:淘宝商品接口统一外层容器code=0:请求正常;非 0 为平台 / 业务错误码request_id:全局请求流水号,日志排查故障专用num_iid:商品唯一数字 ID,查询核心主键title:商品标题;nick:卖家店铺昵称cid/category_name:叶子类目 ID 与类目名称detail_url:淘宝商品详情页链接price:商品原价;promotion_price:实时促销券后价has_discount:布尔值,是否有活动优惠location:商品发货地;express_fee:快递运费(0 包邮)pic_url:商品主图地址item_imgs:详情轮播图片数组,无图为空数组desc:商品详情 HTML 富文本skus:多颜色、尺码规格数组sku_id:子规格唯一 ID;properties:规格文字(颜色 + 尺码)price:单规格售价;stock:单规格库存props_list:商品材质、尺寸、功能等参数数组total_stock:商品总可售库存sell_point:商品短卖点文案skus、item_imgs、props_list为数组,代码必须做空值判断,防止 JSON 解析崩溃;fields按需填写,只拉取业务需要的字段,节省每日调用配额;item:null,业务代码需单独判空处理。原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。