电商API社区，淘宝1688京东商品数据，关键词搜索等

程序猿爱开发Anzexi58
111 阅读10分钟

item_get-获得淘宝商品详情

电商API入口，可测试

请求参数

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

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

响应参数

Version: Date:2022-04-04

名称类型必须示例值描述
itemitem[]1宝贝详情数据
num_iidBigint1520813250866宝贝ID
titleString1三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮宝贝标题
desc_shortString0商品简介
promotion_priceInt0优惠价
priceFloat125.8价格
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
sample_idString0商品风格标识ID
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[]

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=652874751412&is_promotion=1"

响应示例

{
    "item": {
      "num_iid": "520813250866",
      "title": "三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮",
      "desc_short": "",
      "price": 25.8,
      "total_price": 0,
      "suggestive_price": 0,
      "orginal_price": "25.80",
      "nick": "欢乐购客栈",
      "num": "832",
      "min_num": 0,
      "detail_url": "http://item.taobao.com/item.htm?id=520813250866",
      "pic_url": "//img.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg",
      "brand": "三刃木",
      "brandId": "4036703",
      "rootCatId": "50013886",
      "cid": "50014822",
      "favcount": "4824",
      "fanscount": "1469",
      "crumbs": [],
      "created_time": "",
      "modified_time": "",
      "delist_time": "",
      "desc": "<p style="text-align:center;"><span style="color:#ff0000;"><span style="font-size:24.0px;"><strong>小店所有产品都支持刻字，如需刻字，拍之前联系客服即可。</strong></span></span></p> <p style="text-align:center;"><span style="font-size:18.0px;"><strong>炎炎夏日来临，一把随身携带便携式的折叠小刀，<span style="color:#ff0000;">带开瓶器功能</span>，喝酒不用愁。（钥匙刀不带开瓶器功能）</strong></span></p> <p style="text-align:center;"><strong style="color:#000000;line-height:1.5;"><span style="font-size:18.0px;"><span style="line-height:18.0px;">可以当吊牌项链装饰，也可当钥匙扣挂饰， 水果刀 开瓶器 户外防身.</span></span></strong></p> <p style="text-align:center;"><strong style="line-height:1.5;"><span style="font-size:24.0px;">部分客户跟我们反映链子质量还不够好，因此小店已重新订购一批质量更好的链子赠送，<span style="color:#ff0000;">加量不加价</span>，只为让你买的更舒心，戴的更放心。</span></strong></p> <p style="text-align:center;"><span style="font-size:36.0px;"><strong>购买就送<span style="color:#ff0000;">工具刀卡和链子</span>一条</strong></span></p> <p style="text-align:center;"><span style="font-size:36.0px;"><strong><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2Sci2jXXXXXXFXpXXXXXXXXXX_!!2596264565.png" size="611x442"> </strong></span></p> <p style="text-align:center;"><span style="font-size:18.0px;"><strong>璀璨钻石套餐包含【SK016D钥匙扣+GJ019C折叠刀+GJ017D工具卡】</strong></span><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg" size="750x600" /></p> <p style="text-align:center;"><span style="font-size:18.0px;"><strong>超凡大师套餐包括【304不锈钢钥匙扣+GJ019C折叠刀+GJ017D工具卡】</strong></span><a href="//item.taobao.com/item.htm?id=520798805877" target="_blank"><img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2_uiXnFXXXXXBXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="float:none;margin:0.0px;" /></a></p> <p style="text-align:center;">&nbsp;</p> <p style="text-align:center;"><span style="font-size:18.0px;"><strong>最强王者套餐包括【钛钢钥匙扣+GJ019C折叠刀+GJ017D工具卡】<a href="//item.taobao.com/item.htm?id=520801586805" target="_blank"><img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2Gm9xnFXXXXbmXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="float:none;margin:0.0px;" /></a> </strong></span></p> <p style="text-align:center;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB28Ox4b77OyuJjSsplXXXqdpXa_!!2596264565.jpg" size="749x553"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i1/2596264565/TB2.mTddVXXXXbeXpXXXXXXXXXX_!!2596264565.jpg" style="line-height:1.5;" size="750x653"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB21Ro.jl0lpuFjSszdXXcdxFXa_!!2596264565.jpg" size="750x653"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2q9CelVXXXXcUXXXXXXXXXXXX_!!2596264565.jpg" size="750x340"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB21EX9lVXXXXaXXpXXXXXXXXXX_!!2596264565.jpg" size="750x416"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2udCylVXXXXXgXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i1/2596264565/TB2EARxjB8lpuFjSspaXXXJKpXa_!!2596264565.jpg" size="750x515"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2ssuwlVXXXXafXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2nAHqgyC9MuFjSZFoXXbUzFXa_!!2596264565.jpg" size="750x606"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2ahCelVXXXXc_XXXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2w1JnjwRkpuFjy1zeXXc.6FXa_!!2596264565.jpg" size="750x469"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2C902lVXXXXbnXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i1/2596264565/TB2sGR3lVXXXXblXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i1/2596264565/TB2ZBGxlVXXXXXMXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i1/2596264565/TB2MjWklVXXXXcaXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2UgV3lVXXXXbdXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2ip5XlVXXXXX2XpXXXXXXXXXX_!!2596264565.jpg_q90.jpg"> <img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2sMTBdVXXXXXlXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2d3HfdVXXXXahXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2AVbBdVXXXXXkXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2nf_wdVXXXXaMXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2dLYddVXXXXbtXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2H1_adVXXXXbWXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2eBzsdVXXXXbuXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i4/2596264565/TB2dOTndVXXXXcCXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB2fK2tdVXXXXbkXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i2/2596264565/TB29zjedVXXXXaFXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;"><img align="absmiddle" src="//img.alicdn.com/imgextra/i3/2596264565/TB2i7rmdVXXXXcTXXXXXXXXXXXX_!!2596264565.jpg_q90.jpg" style="line-height:1.5;" /></p>",
      "item_imgs": [
        {
          "url": "//img.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg"
        },
        {
          "url": "//img.alicdn.com/imgextra/i2/2596264565/TB2onxRlVXXXXcDXpXXXXXXXXXX_!!2596264565.jpg"
        },
        {
          "url": "//img.alicdn.com/imgextra/i1/2596264565/TB2a.x.lVXXXXXPXpXXXXXXXXXX_!!2596264565.jpg"
        },
        {
          "url": "//img.alicdn.com/imgextra/i2/2596264565/TB2iWE6bKZkyKJjSszbXXblwFXa_!!2596264565.jpg"
        },
        {
          "url": "//img.alicdn.com/imgextra/i4/2596264565/TB2j2cTXib_F1JjSZFzXXc6KXXa_!!2596264565.jpg"
        }
      ],
      "item_weight": "0",
      "item_size": "",
      "location": "广东深圳",
      "post_fee": "",
      "express_fee": "0.00",
      "ems_fee": "",
      "shipping_to": "广东广州白云区",
      "has_discount": "false",
      "video": [],
      "is_virtual": "",
      "sample_id": "",
      "is_promotion": "false",
      "props_name": "1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子;1627207:1195392087:颜色分类:GJ018X钥匙刀+送工具刀卡+链子;1627207:1331112595:颜色分类:超凡大师套餐【送工具卡+链子】;1627207:1331112594:颜色分类:最强王者套餐【送工具卡+链子】;1627207:1331264247:颜色分类:璀璨钻石套餐【送工具卡+链子】",
      "prop_imgs": {
        "prop_img": [
          {
            "properties": "1627207:1347647754",
            "url": "//img.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg"
          },
          {
            "properties": "1627207:1347647753",
            "url": "//img.alicdn.com/imgextra/i4/2596264565/TB2dTrjdVXXXXXBXpXXXXXXXXXX_!!2596264565.jpg"
          },
          {
            "properties": "1627207:1195392087",
            "url": "//img.alicdn.com/imgextra/i2/2596264565/TB2j22kdVXXXXXdXpXXXXXXXXXX_!!2596264565.jpg"
          },
          {
            "properties": "1627207:1331112595",
            "url": "//img.alicdn.com/imgextra/i4/2596264565/TB2_uiXnFXXXXXBXXXXXXXXXXXX_!!2596264565.jpg"
          },
          {
            "properties": "1627207:1331112594",
            "url": "//img.alicdn.com/imgextra/i4/2596264565/TB2Gm9xnFXXXXbmXXXXXXXXXXXX_!!2596264565.jpg"
          },
          {
            "properties": "1627207:1331264247",
            "url": "//img.alicdn.com/imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg"
          }
        ]
      },
      "property_alias": "1627207:1347647754:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:椭圆形带开瓶器+送工具刀卡+链子;1627207:1195392087:GJ018X钥匙刀+送工具刀卡+链子;1627207:1331112595:超凡大师套餐【送工具卡+链子】;1627207:1331112594:最强王者套餐【送工具卡+链子】;1627207:1331264247:璀璨钻石套餐【送工具卡+链子】",
      "props": [
        {
          "name": "品牌",
          "value": "三刃木"
        },
        {
          "name": "产地",
          "value": "中国"
        },
        {
          "name": "颜色分类",
          "value": "长方形带开瓶器+送工具刀卡+链子,椭圆形带开瓶器+送工具刀卡+链子,GJ018X钥匙刀+送工具刀卡+链子,超凡大师套餐【送工具卡+链子】,最强王者套餐【送工具卡+链子】,璀璨钻石套餐【送工具卡+链子】"
        },
        {
          "name": "吊牌价",
          "value": "46"
        },
        {
          "name": "功能数量",
          "value": "5个及以下"
        },
        {
          "name": "货号",
          "value": "GJ019C"
        },
        {
          "name": "附加功能",
          "value": "开瓶器,刀,螺丝刀,钥匙圈,其他"
        }
      ],
      "total_sold": "1",
      "skus": {
        "sku": [
          {
            "price": "39",
            "orginal_price": "39.00",
            "properties": "1627207:1347647754",
            "properties_name": "1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子",
            "quantity": "104",
            "sku_id": "3166598625985"
          },
          {
            "price": "39",
            "orginal_price": "39.00",
            "properties": "1627207:1347647753",
            "properties_name": "1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子",
            "quantity": "370",
            "sku_id": "3166598625984"
          },
          {
            "price": "25.8",
            "orginal_price": "25.80",
            "properties": "1627207:1195392087",
            "properties_name": "1627207:1195392087:颜色分类:GJ018X钥匙刀+送工具刀卡+链子",
            "quantity": "34",
            "sku_id": "3144644292458"
          },
          {
            "price": "73.8",
            "orginal_price": "73.80",
            "properties": "1627207:1331112595",
            "properties_name": "1627207:1331112595:颜色分类:超凡大师套餐【送工具卡+链子】",
            "quantity": "157",
            "sku_id": "3161300228970"
          },
          {
            "price": "91.8",
            "orginal_price": "91.80",
            "properties": "1627207:1331112594",
            "properties_name": "1627207:1331112594:颜色分类:最强王者套餐【送工具卡+链子】",
            "quantity": "0",
            "sku_id": "3161300228969"
          },
          {
            "price": "63.8",
            "orginal_price": "63.80",
            "properties": "1627207:1331264247",
            "properties_name": "1627207:1331264247:颜色分类:璀璨钻石套餐【送工具卡+链子】",
            "quantity": "167",
            "sku_id": "3161107666655"
          }
        ]
      },
      "seller_id": "2596264565",
      "sales": "1",
      "shop_id": "127203758",
      "props_list": {
        "1627207:1347647754": "颜色分类:长方形带开瓶器+送工具刀卡+链子",
        "1627207:1347647753": "颜色分类:椭圆形带开瓶器+送工具刀卡+链子",
        "1627207:1195392087": "颜色分类:GJ018X钥匙刀+送工具刀卡+链子",
        "1627207:1331112595": "颜色分类:超凡大师套餐【送工具卡+链子】",
        "1627207:1331112594": "颜色分类:最强王者套餐【送工具卡+链子】",
        "1627207:1331264247": "颜色分类:璀璨钻石套餐【送工具卡+链子】"
      },
      "seller_info": {
        "title": "欢乐购客栈",
        "shop_name": "欢乐购客栈",
        "sid": "127203758",
        "zhuy": "//shop127203758.taobao.com",
        "level": "12",
        "shop_type": "C",
        "user_num_id": "2596264565",
        "nick": "欢乐购客栈",
        "cid": null,
        "delivery_score": "4.8 ",
        "item_score": "4.8 ",
        "score_p": "4.8 "
      },
      "tmall": "false",
      "error": "",
      "warning": "",
      "url_log": [],
      "stuff_status": "",
      "shopinfo": {
        "shop_name": "欢乐购客栈",
        "shop_id": "127203758"
      },
      "data_from": "mtop",
      "method": "item_mtop:item_get",
      "promo_type": null,
      "props_img": {
        "1627207:1347647754": "//img.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg",
        "1627207:1347647753": "//img.alicdn.com/imgextra/i4/2596264565/TB2dTrjdVXXXXXBXpXXXXXXXXXX_!!2596264565.jpg",
        "1627207:1195392087": "//img.alicdn.com/imgextra/i2/2596264565/TB2j22kdVXXXXXdXpXXXXXXXXXX_!!2596264565.jpg",
        "1627207:1331112595": "//img.alicdn.com/imgextra/i4/2596264565/TB2_uiXnFXXXXXBXXXXXXXXXXXX_!!2596264565.jpg",
        "1627207:1331112594": "//img.alicdn.com/imgextra/i4/2596264565/TB2Gm9xnFXXXXbmXXXXXXXXXXXX_!!2596264565.jpg",
        "1627207:1331264247": "//img.alicdn.com/imgextra/i3/2596264565/TB2wWohmXXXXXX8XXXXXXXXXXXX_!!2596264565.jpg"
      },
      "rate_grade": "",
      "shop_item": [],
      "relate_items": []
    },
    "secache": "d8bd20b8f0d9df02dd030dd374110240",
    "secache_time": 1591841298,
    "secache_date": "2020-06-11 10:08:18",
    "translate_status": "error",
    "translate_time": 0.001,
    "language": {
      "current_lang": "zh-CN",
      "source_lang": "cn"
    },
    "error": "",
    "reason": "",
    "error_code": "0000",
    "cache": 1,
    "api_info": "today:7033 max:10000",
    "execution_time": 0.211,
    "server_time": "Beijing/2020-06-11 10:12:27",
    "call_args": {
      "num_iid": "520813250866",
      "area_id": "440111"
    },
    "api_type": "taobao",
    "translate_language": "zh-CN",
    "translate_engine": "google_cn",
    "server_memory": "8.26MB",
    "request_id": "15ee1930b4e098"
  }

异常示例

{
    "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)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据是
2000Search success but no result接口访问成功，但是搜索没有结果是
4000Server internal error服务器内部错误否
4001Network error网络错误否
4002Target server error目标服务器错误否
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时否
5000unknown error未知错误否

API 工具

avatar
文章
阅读
粉丝