1688商品详情接口:item_get,item_get_pro
通过商品id获取商品详情信息,包括商品标题、价格、url,商品主图、详情图,sku信息等。
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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=610947572360
参数说明:num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
item | item[] | 0 | 宝贝详情数据 | |
num_iid | String | 0 | 610947572360 | 宝贝ID |
title | String | 0 | 厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G | 商品标题 |
desc_short | String | 0 | ||
price | Float | 1 | 799.00 | 价格 |
batch_price | Float | 1 | 799.00 | 批发价格【如代发存在区间起批量 优先展示代发价格】 |
total_price | Float | 0 | 0 | |
suggestive_price | Float | 0 | 0 | |
orginal_price | Float | 0 | 799.00 | 原价 |
nick | String | 0 | qin多亲科技(_sopid@BBBSvyqimnYtLnmm90B_59dsg) | 卖家昵称(以上2种参数都有可能输出,凡是_sopid@开头的即为加密openid) |
num | Int | 0 | 2191 | |
min_num | Int | 0 | 2 | 最小起批量 |
detail_url | String | 0 | https://detail.1688.com/offer/610947572360.html | 宝贝链接 |
pic_url | String | 0 | https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg | 宝贝图片 |
rootCatId | Int | 0 | 0 | 顶级分类ID |
cid | Int | 0 | 124264005 | |
desc | String | 0 | ||
item_imgs | Mix | 0 | item_imgs[] | 商品图片 |
item_weight | String | 0 | ||
video | video[] | 0 | 商品视频 | |
sample_id | String | 0 | ||
props_name | String | 0 | 0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色 | 商品属性名 |
prop_imgs | prop_imgs[] | 0 | 商品属性图片列表 | |
property_alias | String | 0 | 0:0:64GB;1:0:铁灰色;1:1:瓷白色 | 属性别名 |
props | Mix | 0 | [{"name": "品牌", "value": "other"}] | 商品详情 |
total_sold | Int | 0 | 1 | |
scale | Int | 0 | ||
sellUnit | Int | 0 | ||
skus | skus[] | 0 | 商品规格信息列表 | |
seller_id | Int | 0 | 2206619673102 | 卖家ID |
sales | Int | 0 | 100 | 销售额 |
shop_id | Int | 0 | 151372205 | 店铺ID |
props_list | Mix | 0 | {"0:0": "机身内存:64GB"} | 商品属性 |
tmall | Boolean | 0 | false | 是否天猫 |
data_from | String | 0 | 1688app | 错误信息 |
error | String | 0 | 错误信息 | |
unit | String | 0 | 部; | 单位 |
is_support_mix | Boolean | 0 | true | |
mix_amount | Int | 0 | 30 | |
mix_Begin | Int | 0 | ||
mix_number | Int | 0 | ||
sales_data | Date | 0 | ||
location | String | 0 | 广东省 深圳市 | 发货地 |
props_img | Mix | 0 | 属性图片 | |
sales_info | Mix | 0 | ||
desc_img | Mix | 0 | [{"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg"}] | 详情图片列表 |
shop_item | Mix | 0 | ||
relate_items | Mix | 0 |
响应示例
"item": { "num_iid": "952042688449", "title": "辣妹性感美式挂脖吊带小背心女夏季带胸垫新款设计感小众美背上衣", "desc_short": "", "price": "12.10", "total_price": 0, "suggestive_price": 0, "orginal_price": "12.10", "nick": "汕头市潮阳区贵屿鑫顺发针织内衣厂", "num": 124762, "min_num": 20, "detail_url": "https://detail.1688.com/offer/952042688449.html", "pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN011iB2gE2JzqvRBkyMG_!!2206789229493-0-cib.jpg", "brand": "", "brandId": "", "rootCatId": 10166, "cid": 1031920, "desc": "<div id=\"offer-template-0\"></div><div title=\"SHOPTOOL_POSITION_TOP_BEGIN\"> </div>\r\n<div title=\"SHOPTOOL_关联营销_596355_BEGIN\"> </div>\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td > </td>\r\n</tr>\r\n<tr>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01MXHvva2JzqwSWw6Tt_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01NicsJa2JzqwBA3O1v_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01t6E8Jr2JzqwDCrTWE_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01tuG2Pc2JzqwM75HcZ_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n</tr>\r\n<tr>\r\n<td > </td>\r\n</tr>\r\n<tr>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01pRFczP2Jzqw7bPT00_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01dYxlKE2Jzqw6wRPlI_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01fYP8SP2Jzqw60HCl9_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN017kiO7t2JzqvvVlSsn_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n</tr>\r\n<tr>\r\n<td > </td>\r\n</tr>\r\n<tr>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01xvVIG82Jzqvvrni7X_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01MphTHr2JzqviYTHzi_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01w8pp4d2JzqvBmU4m3_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01yTZK9n2JzqtFw7DJJ_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n</tr>\r\n<tr>\r\n<td > </td>\r\n</tr>\r\n<tr>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01nM9XGb2Jzqv7PL6NQ_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01qZdKqM2Jzquf6nwOs_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01QjSHw22JzquA05wX4_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td > </td>\r\n<td width=\"187\" valign=\"midden\" > <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01IoaSJe2Jzqu0d6F2J_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n</tr>\r\n<tr>\r\n<td > </td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n<div title=\"SHOPTOOL_关联营销_596355_END\"> </div>\r\n<div title=\"SHOPTOOL_POSITION_TOP_END\"> </div>\r\n<div><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN0103fjbc2JzqvOqHU8e_!!2206789229493-0-cib.jpg\" alt=\"f50c6017-e4ad-4319-98f5-6f80cd34a677.jpe\"/> <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01zOP3TY2JzqvOuAEX9_!!2206789229493-0-cib.jpg\" alt=\"f87b0226-5bf2-48f3-ae09-df4457fde524.jpe\"/> <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01X44dwZ2JzqvPxPdKg_!!2206789229493-0-cib.jpg\" alt=\"203036b5-6059-4f3c-b8c8-fca49d35b20c.jpe\"/> <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01dqJ1Jh2JzqvOqGTl6_!!2206789229493-0-cib.jpg\" alt=\"663a91ee-9142-45ae-94c3-328e98ab94ae.jpe\"/> <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01CFMhoR2JzqvOPW3HU_!!2206789229493-0-cib.jpg\" alt=\"80306dc1-5eb4-447c-a464-b83d8246a1a2.jpe\"/> <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01DMMsMM2JzqvRSZ2Ao_!!2206789229493-0-cib.jpg\" alt=\"bb054391-c2d5-4592-86c7-f3134727d5a2.jpe\"/> <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01aroTHD2JzqvPgKzCK_!!2206789229493-0-cib.jpg\" alt=\"b05ca283-a76e-4d96-9453-9252117f0468.jpe\"/> <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01grQuzu2JzqvPxSqwW_!!2206789229493-0-cib.jpg\" alt=\"af19539d-d5b3-4c51-a927-4a1b40ad8af4.jpe\"/> <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01NUEyXr2JzqvPgVjeO_!!2206789229493-0-cib.jpg\" alt=\"74cb945b-31ab-4e7e-8953-d348171073e1.jpe\"/> <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01f9ed1F2JzqvRSYdEk_!!2206789229493-0-cib.jpg\" alt=\"e5e0a61c-0324-4f18-830b-f17453ab49a2.jpe\"/> <img src=\"https://cbu01.alicdn.com/img/ibank/O1CN011NSRWS2JzqvOPVRvQ_!!2206789229493-0-cib.jpg\" alt=\"d430b0e7-2c34-43ac-bb54-d7f2c7b08953.jpe\"/></div><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.69e8843ddc446&p=1778789846&k=i_key&t=1776845888\" style=\"display:none\" />", "item_imgs": [ { "url": "https://cbu01.alicdn.com/img/ibank/O1CN011iB2gE2JzqvRBkyMG_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN01ENWxfP2JzqvK4Gx7l_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN014CUZd42JzqvQfMbXG_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN01pQXRde2JzqvOPVRuz_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN01Bas4472JzqvOu8pCq_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN01ZkBeoJ2JzqyxsHUXv_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN016pF3PA2JzqvPxS7DF_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN014J2BFH2JzqvPgT3LU_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN01s9LmR22JzqyxsJhm4_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN01AqAyz62JzqvQEXdh3_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN016vnonQ2JzqyxsHlBb_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN01dlb9Kb2Jzqz2a5TQL_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN01zP5XAN2JzqvQcIZXZ_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN0170N9hg2JzqvOuAMr8_!!2206789229493-0-cib.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/O1CN01uwTic82Jzqz2pJD5s_!!2206789229493-0-cib.jpg" } ], "item_weight": null, "location": "广东省汕头市", "post_fee": null, "express_fee": null, "ems_fee": "", "shipping_to": "", "video": { "url": "https://cloud.video.taobao.com/play/u/2206789229493/p/2/e/6/t/1/509480741609.mp4" }, "sample_id": "", "props_name": "0:0:颜色:黑色【高质量-固定杯】113#;0:1:颜色:灰色【高质量-固定杯】113#;0:2:颜色:藏青色【高质量-固定杯】113#;0:3:颜色:白色【高质量-固定杯】113#;0:4:颜色:红色【高质量-固定杯】113#;0:5:颜色:黑色【高质量-固定杯】225#;0:6:颜色:白色【高质量-固定杯】225#;0:7:颜色:红色【高质量-固定杯】225#;0:8:颜色:杏色【高质量-固定杯】225#;0:9:颜色:粉色【高质量-固定杯】225#;1:0:尺码:均码(80-130斤)", "prop_imgs": { "prop_img": [ { "properties": "0:0", "url": "https://cbu01.alicdn.com/img/ibank/O1CN014J2BFH2JzqvPgT3LU_!!2206789229493-0-cib.jpg" }, { "properties": "0:1", "url": "https://cbu01.alicdn.com/img/ibank/O1CN0170N9hg2JzqvOuAMr8_!!2206789229493-0-cib.jpg" }, { "properties": "0:2", "url": "https://cbu01.alicdn.com/img/ibank/O1CN01zP5XAN2JzqvQcIZXZ_!!2206789229493-0-cib.jpg" }, { "properties": "0:3", "url": "https://cbu01.alicdn.com/img/ibank/O1CN01AqAyz62JzqvQEXdh3_!!2206789229493-0-cib.jpg" }, { "properties": "0:4", "url": "https://cbu01.alicdn.com/img/ibank/O1CN016pF3PA2JzqvPxS7DF_!!2206789229493-0-cib.jpg" }, { "properties": "0:5", "url": "https://cbu01.alicdn.com/img/ibank/O1CN01uwTic82Jzqz2pJD5s_!!2206789229493-0-cib.jpg" }, { "properties": "0:6", "url": "https://cbu01.alicdn.com/img/ibank/O1CN01ZkBeoJ2JzqyxsHUXv_!!2206789229493-0-cib.jpg" }, { "properties": "0:7", "url": "https://cbu01.alicdn.com/img/ibank/O1CN016vnonQ2JzqyxsHlBb_!!2206789229493-0-cib.jpg" }, { "properties": "0:8", "url": "https://cbu01.alicdn.com/img/ibank/O1CN01dlb9Kb2Jzqz2a5TQL_!!2206789229493-0-cib.jpg" }, { "properties": "0:9", "url": "https://cbu01.alicdn.com/img/ibank/O1CN01s9LmR22JzqyxsJhm4_!!2206789229493-0-cib.jpg" } ] }, "property_alias": "0:0:黑色【高质量-固定杯】113#;0:1:灰色【高质量-固定杯】113#;0:2:藏青色【高质量-固定杯】113#;0:3:白色【高质量-固定杯】113#;0:4:红色【高质量-固定杯】113#;0:5:黑色【高质量-固定杯】225#;0:6:白色【高质量-固定杯】225#;0:7:红色【高质量-固定杯】225#;0:8:杏色【高质量-固定杯】225#;0:9:粉色【高质量-固定杯】225#;1:0:均码(80-130斤)", "props": [ { "name": "主面料成分", "value": "棉" }, { "name": "款式", "value": "肩带款" }, { "name": "面料名称", "value": "棉" }, { "name": "品牌", "value": "鑫顺发" }, { "name": "弹力", "value": "无弹" }, { "name": "衣长", "value": "长款(80cm<衣长≤100cm)" }, { "name": "流行元素", "value": "吊带" }, { "name": "版型", "value": "A字型" }, { "name": "货号", "value": "1132" }, { "name": "图案", "value": "见详情" }, { "name": "上市年份/季节", "value": "2025夏季" }, { "name": "颜色", "value": "黑色【高质量-固定杯】113#,灰色【高质量-固定杯】113#,藏青色【高质量-固定杯】113#,白色【高质量-固定杯】113#,红色【高质量-固定杯】113#,黑色【高质量-固定杯】225#,白色【高质量-固定杯】225#,红色【高质量-固定杯】225#,杏色【高质量-固定杯】225#,粉色【高质量-固定杯】225#" }, { "name": "尺码", "value": "均码(80-130斤)" }, { "name": "主面料成分含量", "value": "95%及以上" }, { "name": "风格类型", "value": "气质通勤" }, { "name": "货源类型", "value": "国内一二线品牌" }, { "name": "吊牌", "value": "无吊牌" }, { "name": "肩带样式", "value": "Y型背带" }, { "name": "适用季节", "value": "四季通用" }, { "name": "风格", "value": "都市风" }, { "name": "是否跨境货源", "value": "否" }, { "name": "领标", "value": "已剪标" }, { "name": "主面料成分2含量", "value": "30%(含)-50%(不含)" }, { "name": "主面料成分2", "value": "棉/棉" } ], "total_sold": 1912, "scale": null, "sellUnit": null, "skus": { "sku": [ { "price": "12.98", "total_price": 0, "sales": 0, "properties": "0:0;1:0", "properties_name": "0:0:颜色:黑色【高质量-固定杯】113#;1:0:尺码:均码(80-130斤)", "quantity": 12419, "sku_id": 6221752915089, "spec_id": "5908d52fa87098c2610a1f06428bf95b" }, { "price": "12.98", "total_price": 0, "sales": 0, "properties": "0:1;1:0", "properties_name": "0:1:颜色:灰色【高质量-固定杯】113#;1:0:尺码:均码(80-130斤)", "quantity": 12320, "sku_id": 6221752915090, "spec_id": "ae1d8559cc7438c1305ddf1648f94946" }, { "price": "12.98", "total_price": 0, "sales": 0, "properties": "0:2;1:0", "properties_name": "0:2:颜色:藏青色【高质量-固定杯】113#;1:0:尺码:均码(80-130斤)", "quantity": 12425, "sku_id": 6221752915097, "spec_id": "479acc82b24f10aef518eaba4c1971e9" }, { "price": "12.98", "total_price": 0, "sales": 0, "properties": "0:3;1:0", "properties_name": "0:3:颜色:白色【高质量-固定杯】113#;1:0:尺码:均码(80-130斤)", "quantity": 12419, "sku_id": 6221752915098, "spec_id": "793e61669531b5b9870c733c94c3d742" }, { "price": "12.98", "total_price": 0, "sales": 0, "properties": "0:4;1:0", "properties_name": "0:4:颜色:红色【高质量-固定杯】113#;1:0:尺码:均码(80-130斤)", "quantity": 12521, "sku_id": 6221752915099, "spec_id": "cfde65e181b1697824e9b4c22565937a" }, { "price": "12.98", "total_price": 0, "sales": 0, "properties": "0:5;1:0", "properties_name": "0:5:颜色:黑色【高质量-固定杯】225#;1:0:尺码:均码(80-130斤)", "quantity": 12529, "sku_id": 6221752915092, "spec_id": "b5b6c5ed9e5e60ce0ae19895e75b6f0e" }, { "price": "12.98", "total_price": 0, "sales": 0, "properties": "0:6;1:0", "properties_name": "0:6:颜色:白色【高质量-固定杯】225#;1:0:尺码:均码(80-130斤)", "quantity": 12524, "sku_id": 6221752915093, "spec_id": "e61214526ed20bd3169ac7abd527b686" }, { "price": "12.98", "total_price": 0, "sales": 0, "properties": "0:7;1:0", "properties_name": "0:7:颜色:红色【高质量-固定杯】225#;1:0:尺码:均码(80-130斤)", "quantity": 12532, "sku_id": 6221752915094, "spec_id": "535c679013842afeb53fd4d94b55a6ee" }, { "price": "12.98", "total_price": 0, "sales": 0, "properties": "0:8;1:0", "properties_name": "0:8:颜色:杏色【高质量-固定杯】225#;1:0:尺码:均码(80-130斤)", "quantity": 12535, "sku_id": 6221752915095, "spec_id": "e0b9600a93f0f4c77409eafe5d089369" }, { "price": "12.98", "total_price": 0, "sales": 0, "properties": "0:9;1:0", "properties_name": "0:9:颜色:粉色【高质量-固定杯】225#;1:0:尺码:均码(80-130斤)", "quantity": 12538, "sku_id": 6221752915096, "spec_id": "a54231c03cdd679758f794f37fa307d0" } ] },