获取淘宝商品详情数据API对接完全指南

用户05161046167
52 阅读5分钟

​

 本文提供淘宝商品详情数据的完整API对接方案，包含商品标题、价格、详情、主图、店铺等信息。

1、获取商品价格详情API：item_get

公共参数

名称类型必须描述
keyString是调用key（必须以GET方式拼接在URL中）
secretString是调用密钥
api_nameString是API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cacheString否[yes,no]默认yes，将调用缓存的数据，速度比较快
result_typeString否[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
langString否[cn,en,ru]翻译语言，默认cn简体中文
versionString否API版本

请求参数

请求参数：num_iid=652874751412&is_promotion=1

参数说明：num_iid:淘宝商品ID
is_promotion:是否获取取促销价

响应参数

名称类型必须示例值描述
itemitem[]1宝贝详情数据(部分商品获取不到)
num_iidBigint1520813250866宝贝ID
titleString1三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮宝贝标题
desc_shortString0商品简介
promotion_priceInt0优惠价
priceFloat125.8价格(当商品价格为0时，当前值为-1)，价格来自于未登入的划线价格，会有个别商品价格无法与页面匹配
total_priceFloat00
suggestive_priceFloat00
orginal_priceString025.80原价
nickString0欢乐购客栈掌柜昵称
numInt03836库存(没有精确，是模糊值)
min_numInt00最小购买数
detail_urlString0item.taobao.com/item.htm?id…宝贝链接
pic_urlString1//gd2.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg宝贝图片
brandString0三刃木品牌名称
brandIdInt08879363品牌ID
rootCatIdInt050013886顶级分类ID
cidInt150014822
crumbsMix0[]导航菜单
created_timeString0
modified_timeString0
delist_timeString0
descString0商品详情【暂时不支持】
desc_imgMix0[]商品详情图片【暂时不支持】
item_imgsMix0item_imgs[]商品图片
item_weightString0
item_sizeString0
locationString0发货地
express_feeFloat00.00快递费用
ems_feeFloat0EMS费用
post_feeFloat0物流费用
shipping_toString0发货至
has_discountBoolean0false是否有优惠
videovideo[]0商品视频
is_virtualString0
is_promotionBoolean0false是否促销
props_nameString01627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子;商品属性名。格式为pid1:vid1:name1:value1;pid1:vid2:name2:value2。
prop_imgsprop_imgs[]0商品属性图片列表
property_aliasString020509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色销售属性值别名。格式为pid1:vid1:alias1;pid1:vid2:alia2。
propsMix0[{ "name": "产地","value": "中国" }]商品属性
total_soldInt0
skusskus[]0商品规格信息列表
seller_idInt02844096782卖家ID
salesInt0138销量
shop_idInt0151372205店铺ID
props_listMix0{20509:9974422: 尺码:36}商品属性
seller_infoseller_info[]1卖家信息
tmallBoolean0false是否天猫
errorString0错误信息
warningString0警告信息
url_logMix0[]
favcountInt00
fanscountInt00
methodString0item_tmall:pget_item
promo_typeString0
props_imgMix01627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg属性图片
shop_itemMix0[]
relate_itemsMix0[]

2、item_video-获得淘宝商品视频

请求参数

请求参数：num_iid=906637149849

参数说明：num_iid:淘宝商品ID

响应参数

Version: Date:2025-06-17

名称类型必须示例值描述
itemitem[]1宝贝视频数据【仅保障视频参数】
num_iidBigint1906637149849宝贝ID
titleString0【爆款推荐】巨好看！软底人字拖
detail_urlString1item.taobao.com/item.htm?id…宝贝链接
priceFloat045.9价格
orginal_priceString045.9原价
numInt03836库存
pic_urlString0img.alicdn.com/imgextra/i1…宝贝图片
brandString0南在南方品牌名称
cidInt0201276457
propsMix0[{ "name": "产地","value": "中国" }]商品属性
item_imgsMix0item_imgs[]商品图片
videoString1cloud.video.taobao.com/play/u/1814…商品视频
seller_idInt0181441304卖家ID

响应示例

{
    "item": {
        "num_iid": "906637149849",
        "title": "【爆款推荐】巨好看！软底人字拖",
        "detail_url": "http://item.taobao.com/item.htm?id=906637149849",
        "pic_url": "http://img.alicdn.com/imgextra/i1/181441304/O1CN01nh2zTN1LVHVzbBH9w_!!181441304.jpg",
        "price": "45.9",
        "orginal_price": 45.9,
        "cid": 201276457,
        "item_imgs": [
            {
                "url": "http://img.alicdn.com/imgextra/i1/181441304/O1CN01nh2zTN1LVHVzbBH9w_!!181441304.jpg"
            }
        ],
        "brand": "南在南方",
        "props": [
            {
                "name": "品牌",
                "value": "南在南方"
            },
            {
                "name": "风格",
                "value": "休闲"
            },
            {
                "name": "里料材质",
                "value": "PU"
            },
            {
                "name": "尺码",
                "value": "35,40,37,36,38,39"
            },
            {
                "name": "销售渠道类型",
                "value": "纯电商(只在线上销售)"
            },
            {
                "name": "适用对象",
                "value": "青年"
            },
            {
                "name": "适合场合",
                "value": "日常"
            },
            {
                "name": "帮面材质",
                "value": "PU"
            },
            {
                "name": "鞋制作工艺",
                "value": "胶粘鞋"
            },
            {
                "name": "后跟高",
                "value": "中跟(3-5cm)"
            },
            {
                "name": "上市年份季节",
                "value": "2025年夏季"
            },
            {
                "name": "产地",
                "value": "中国"
            },
            {
                "name": "鞋垫材质",
                "value": "PU"
            },
            {
                "name": "跟底款式",
                "value": "平底"
            },
            {
                "name": "图案",
                "value": "纯色"
            },
            {
                "name": "鞋底材质",
                "value": "橡胶"
            },
            {
                "name": "鞋靴闭合方式",
                "value": "一脚蹬"
            },
            {
                "name": "颜色分类",
                "value": "银色,紫色,黑色,紫色升级版,黑色升级版,米色升级版,银色升级版,米色"
            }
        ],
        "num": "200",
        "seller_id": "181441304",
        "video": {
            "url": "http://cloud.video.taobao.com/play/u/181441304/p/2/e/6/t/1/514242949225.mp4?appKey=38829"
        }
    },
}

详情API接口在电商领域有着广泛的应用场景，无论是数据分析、商品监控、智能选品还是自动补货，它都能发挥重要的作用。欢迎大家评论区留言讨论！

avatar
文章
阅读
粉丝