https://apiceshiwang.com/Good Luck To You!https://apiceshiwang.com/?id=209<h1 spellcheck="false" class="pgc-h-forward-slash" data-track="1" data-pm-slice="1 1 []"><span style="font-size: 14px;">一、接口是什么</span></h1><p data-track="3">只要传入一个商品 SKU ID，就能拿到标题、价格、库存、规格、图片、评价等结构化信息，常用于商品同步、比价监控和选品分析。</p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="4">二、怎么调用</h1><ol start="1" class=" list-paddingleft-2"><li><p><strong>获取密钥</strong>：在开放平台创建应用，拿到 AppKey 与 AppSecret，并申请商品详情查询权限（o0b.cn/anzexi）。</p></li><li><p><strong>生成签名</strong>：非空参数按参数名 ASCII 升序排序，<strong>只拼各参数的 value</strong>，首尾各接一次 AppSecret，MD5 后转大写。</p></li><li><p><strong>发起请求</strong>：HTTPS POST 到o0b.cn/anzexi，核心参数是 skuId。</p></li></ol><blockquote><p data-track="8">注意：时间戳须为 yyyy-MM-dd HH:mm:ss（东八区），与服务器时间相差超过 10 分钟会被网关拒绝。</p></blockquote><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="9">三、JSON 返回参考</h1><pre language="javascript" code_block="true">{ &nbsp;&nbsp;&quot;jd_union_open_goods_detail_query_response&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;code&quot;:&nbsp;&quot;0&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;msg&quot;:&nbsp;&quot;success&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;requestId&quot;:&nbsp;&quot;req_20261012170055431&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;result&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;goodsInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuId&quot;:&nbsp;&quot;100012345678&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;spuId&quot;:&nbsp;&quot;100012345600&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;title&quot;:&nbsp;&quot;2026夏季新款纯棉短袖T恤&nbsp;男女同款宽松版&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;brandName&quot;:&nbsp;&quot;XX品牌&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;shopName&quot;:&nbsp;&quot;XX官方旗舰店&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isJdSelf&quot;:&nbsp;false, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;itemUrl&quot;:&nbsp;&quot;https://item.jd.com/100012345678.html&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;priceInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;originalPrice&quot;:&nbsp;&quot;99.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;discountPrice&quot;:&nbsp;&quot;59.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;lowestPrice30Days&quot;:&nbsp;&quot;55.00&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;hasCoupon&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;finalPrice&quot;:&nbsp;&quot;49.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponList&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponId&quot;:&nbsp;&quot;cp20261012001&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponDiscount&quot;:&nbsp;&quot;10.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponDesc&quot;:&nbsp;&quot;满59减10元店铺券&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;endTime&quot;:&nbsp;&quot;2026-10-31&nbsp;23:59:59&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stockInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;totalStock&quot;:&nbsp;950, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isSale&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stockStatus&quot;:&nbsp;&quot;in_stock&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;salesInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;totalSales&quot;:&nbsp;12580, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;monthSales&quot;:&nbsp;3210 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;imageInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;mainImg&quot;:&nbsp;&quot;https://img10.360buyimg.com/n1/jfs/t1/xxx/main.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;detailImgList&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img10.360buyimg.com/n1/jfs/t1/xxx/d1.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img10.360buyimg.com/n1/jfs/t1/xxx/d2.jpg&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuList&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuId&quot;:&nbsp;&quot;10001234567801&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specText&quot;:&nbsp;&quot;白色&nbsp;M&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specs&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;颜色&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;白色&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;尺码&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;M&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuPrice&quot;:&nbsp;&quot;59.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuStock&quot;:&nbsp;320, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isAvailable&quot;:&nbsp;true &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuId&quot;:&nbsp;&quot;10001234567803&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specText&quot;:&nbsp;&quot;红色&nbsp;S&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuPrice&quot;:&nbsp;&quot;59.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuStock&quot;:&nbsp;0, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isAvailable&quot;:&nbsp;false &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;productParams&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;面料&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;100%棉&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;版型&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;宽松型&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;commentSummary&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;goodRateShow&quot;:&nbsp;&quot;97.2&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;commentCount&quot;:&nbsp;1860 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} }</pre><p data-track="11"><br/></p><p><br/></p>Sun, 18 Oct 2026 16:35:24 +0800https://apiceshiwang.com/?id=208<p data-track="266" data-pm-slice="1 1 []">一、接口定位</p><p data-track="3">京东商品详情数据接口（jd.union.open.goods.detail.query）是京东开放平台的核心数据入口。传入一个商品 SKU ID，即可返回标题、价格、优惠券、库存、SKU规格、图片、评价等全维度结构化数据，适用于商品同步、比价监控、选品分析等场景。</p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="4">二、接入三步</h1><ol start="1" class=" list-paddingleft-2"><li><p><strong>拿密钥</strong>：在京东开放平台创建应用，获取 AppKey 和 AppSecret，并申请商品详情查询权限。密钥o0b.cn/anzexi</p></li><li><p><strong>算签名</strong>：把非空参数按参数名 ASCII 升序排序，<strong>只拼接各参数的 value</strong>，首尾各加一次 AppSecret，做 MD5 后转大写。</p></li><li><p><strong>发请求</strong>：以 HTTPS POST 提交到网关 https://api.jd.com/routerjson，核心业务参数为 skuId。</p></li></ol><blockquote><p data-track="8">提醒：时间戳格式必须是 yyyy-MM-dd HH:mm:ss（东八区），与服务器时间偏差超过 10 分钟会被直接拒绝。</p></blockquote><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="9">三、标准JSON返回参考</h1><pre language="javascript" code_block="true">{ &nbsp;&nbsp;&quot;jd_union_open_goods_detail_query_response&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;code&quot;:&nbsp;&quot;0&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;msg&quot;:&nbsp;&quot;success&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;requestId&quot;:&nbsp;&quot;req_20261012164533120&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;result&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;goodsInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuId&quot;:&nbsp;&quot;100012345678&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;spuId&quot;:&nbsp;&quot;100012345600&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;title&quot;:&nbsp;&quot;2026夏季新款纯棉短袖T恤&nbsp;男女同款宽松版&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;brandName&quot;:&nbsp;&quot;XX品牌&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;shopName&quot;:&nbsp;&quot;XX官方旗舰店&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isJdSelf&quot;:&nbsp;false, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;itemUrl&quot;:&nbsp;&quot;https://item.jd.com/100012345678.html&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;priceInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;originalPrice&quot;:&nbsp;&quot;99.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;discountPrice&quot;:&nbsp;&quot;59.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;lowestPrice30Days&quot;:&nbsp;&quot;55.00&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;hasCoupon&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;finalPrice&quot;:&nbsp;&quot;49.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponList&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponId&quot;:&nbsp;&quot;cp20261012001&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponDiscount&quot;:&nbsp;&quot;10.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponDesc&quot;:&nbsp;&quot;满59减10元店铺券&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;endTime&quot;:&nbsp;&quot;2026-10-31&nbsp;23:59:59&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stockInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;totalStock&quot;:&nbsp;950, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isSale&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stockStatus&quot;:&nbsp;&quot;in_stock&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;salesInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;totalSales&quot;:&nbsp;12580, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;monthSales&quot;:&nbsp;3210 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;imageInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;mainImg&quot;:&nbsp;&quot;https://img10.360buyimg.com/n1/jfs/t1/xxx/main.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;detailImgList&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img10.360buyimg.com/n1/jfs/t1/xxx/d1.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img10.360buyimg.com/n1/jfs/t1/xxx/d2.jpg&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuList&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuId&quot;:&nbsp;&quot;10001234567801&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specText&quot;:&nbsp;&quot;白色&nbsp;M&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specs&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;颜色&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;白色&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;尺码&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;M&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuPrice&quot;:&nbsp;&quot;59.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuStock&quot;:&nbsp;320, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isAvailable&quot;:&nbsp;true &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuId&quot;:&nbsp;&quot;10001234567803&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specText&quot;:&nbsp;&quot;红色&nbsp;S&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuPrice&quot;:&nbsp;&quot;59.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuStock&quot;:&nbsp;0, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isAvailable&quot;:&nbsp;false &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;productParams&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;面料&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;100%棉&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;版型&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;宽松型&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;commentSummary&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;goodRateShow&quot;:&nbsp;&quot;97.2&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;commentCount&quot;:&nbsp;1860 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} }</pre><p data-track="11"><br/></p><p><br/></p>Tue, 13 Oct 2026 17:03:57 +0800https://apiceshiwang.com/?id=207<p data-track="815" data-pm-slice="1 1 []">一、主题定位</p><p data-track="479">本文只讲<strong>开发实现</strong>这一层：请求怎么构造、签名怎么算、返回的 JSON 怎么解析。面向正在写对接代码的开发者，不铺开讲业务价值。</p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="480">二、请求构造的三步</h1><p data-track="481"><strong>第 1 步：组装公共参数</strong></p><pre language="javascript" code_block="true">params&nbsp;=&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;app_key&quot;:&nbsp;&quot;your_app_key&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;method&quot;:&nbsp;&quot;jd.union.open.goods.detail.query&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;timestamp&quot;:&nbsp;&quot;2026-10-12&nbsp;16:30:00&quot;,&nbsp;&nbsp;&nbsp;#&nbsp;东八区，格式固定 &nbsp;&nbsp;&nbsp;&nbsp;&quot;format&quot;:&nbsp;&quot;json&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;v&quot;:&nbsp;&quot;1.0&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;sign_method&quot;:&nbsp;&quot;md5&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;skuId&quot;:&nbsp;&quot;100012345678&quot;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;业务参数，核心入参 }</pre><p data-track="514"><strong>第 2 步：计算签名</strong><br/>京东的签名规则是<strong>只拼 value、不拼 key</strong>：</p><pre language="javascript" code_block="true">import&nbsp;hashlib def&nbsp;make_sign(params,&nbsp;app_secret): &nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;1.&nbsp;剔除&nbsp;sign，按&nbsp;key&nbsp;的&nbsp;ASCII&nbsp;升序排序 &nbsp;&nbsp;&nbsp;&nbsp;keys&nbsp;=&nbsp;sorted(k&nbsp;for&nbsp;k&nbsp;in&nbsp;params&nbsp;if&nbsp;k&nbsp;!=&nbsp;&quot;sign&quot;&nbsp;and&nbsp;params[k]&nbsp;!=&nbsp;&quot;&quot;) &nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;2.&nbsp;只拼接&nbsp;value &nbsp;&nbsp;&nbsp;&nbsp;raw&nbsp;=&nbsp;&quot;&quot;.join(str(params[k])&nbsp;for&nbsp;k&nbsp;in&nbsp;keys) &nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;3.&nbsp;首尾各拼一次&nbsp;secret &nbsp;&nbsp;&nbsp;&nbsp;src&nbsp;=&nbsp;app_secret&nbsp;+&nbsp;raw&nbsp;+&nbsp;app_secret &nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;4.&nbsp;MD5&nbsp;后转大写 &nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;hashlib.md5(src.encode(&quot;utf-8&quot;)).hexdigest().upper()</pre><p data-track="555"><strong>第 3 步：POST 到网关</strong><br/>https://api.jd.com/routerjson，Content-Type 用 application/x-www-form-urlencoded。</p><blockquote><p data-track="556">三个高频踩坑点：① 拼成 key=value（应为只拼 value）；② 排序前没剔除空值参数；③ timestamp 格式不是 yyyy-MM-dd HH:mm:ss，超出 ±10 分钟窗口会被网关直接拒绝。</p></blockquote><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="557">三、标准 JSON 返回参考</h1><p data-track="814">测试o0b.cn/anzexi</p><pre language="javascript" code_block="true">{ &nbsp;&nbsp;&quot;jd_union_open_goods_detail_query_response&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;code&quot;:&nbsp;&quot;0&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;msg&quot;:&nbsp;&quot;success&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;requestId&quot;:&nbsp;&quot;req_20261012163012456&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;result&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;goodsInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuId&quot;:&nbsp;&quot;100012345678&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;spuId&quot;:&nbsp;&quot;100012345600&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;title&quot;:&nbsp;&quot;2026夏季新款纯棉短袖T恤&nbsp;男女同款宽松版&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;brandName&quot;:&nbsp;&quot;XX品牌&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;shopName&quot;:&nbsp;&quot;XX官方旗舰店&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isJdSelf&quot;:&nbsp;false, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;itemUrl&quot;:&nbsp;&quot;https://item.jd.com/100012345678.html&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;priceInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;originalPrice&quot;:&nbsp;&quot;99.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;discountPrice&quot;:&nbsp;&quot;59.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;lowestPrice30Days&quot;:&nbsp;&quot;55.00&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;hasCoupon&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;finalPrice&quot;:&nbsp;&quot;49.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponList&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponId&quot;:&nbsp;&quot;cp20261012001&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponDiscount&quot;:&nbsp;&quot;10.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;couponDesc&quot;:&nbsp;&quot;满59减10元店铺券&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;endTime&quot;:&nbsp;&quot;2026-10-31&nbsp;23:59:59&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stockInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;totalStock&quot;:&nbsp;950, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isSale&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stockStatus&quot;:&nbsp;&quot;in_stock&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;salesInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;totalSales&quot;:&nbsp;12580, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;monthSales&quot;:&nbsp;3210 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;imageInfo&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;mainImg&quot;:&nbsp;&quot;https://img10.360buyimg.com/n1/jfs/t1/xxx/main.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;detailImgList&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img10.360buyimg.com/n1/jfs/t1/xxx/d1.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img10.360buyimg.com/n1/jfs/t1/xxx/d2.jpg&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuList&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuId&quot;:&nbsp;&quot;10001234567801&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specText&quot;:&nbsp;&quot;白色&nbsp;M&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specs&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;颜色&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;白色&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;尺码&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;M&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuPrice&quot;:&nbsp;&quot;59.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuStock&quot;:&nbsp;320, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isAvailable&quot;:&nbsp;true &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuId&quot;:&nbsp;&quot;10001234567803&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specText&quot;:&nbsp;&quot;红色&nbsp;S&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuPrice&quot;:&nbsp;&quot;59.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;skuStock&quot;:&nbsp;0, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;isAvailable&quot;:&nbsp;false &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;productParams&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;面料&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;100%棉&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;版型&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;宽松型&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;commentSummary&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;goodRateShow&quot;:&nbsp;&quot;97.2&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;commentCount&quot;:&nbsp;1860 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} }</pre><p data-track="559"><br/></p><p><br/></p>Mon, 12 Oct 2026 16:42:23 +0800https://apiceshiwang.com/?id=206<p data-track="152" data-pm-slice="1 1 []">文档说明</p><p data-track="3">本文档面向开发者，用于快速对接京东详情<br/>接口核心作用：通过商品SKU ID，实时拉取标题、价格、库存、SKU规格、主图、等结构化全量商品数据。<br/>适用场景：商品信息同步、价格监控、ERP对接、合规电商数据采集。<br/>调用基础要求：在开放平台完成开发者认证（o0b.cn/anzexi），获取AppKey、AppSecret 即可发起请求。</p><hr/><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="4">标准JSON返回参考</h1><pre language="javascript" code_block="true">{ &nbsp;&nbsp;&quot;jd_product_detail_get_response&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;code&quot;:&nbsp;0, &nbsp;&nbsp;&nbsp;&nbsp;&quot;msg&quot;:&nbsp;&quot;success&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;request_id&quot;:&nbsp;&quot;jd_20261010160822001&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;data&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_id&quot;:&nbsp;100012345678, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;spu_id&quot;:&nbsp;100087654321, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;title&quot;:&nbsp;&quot;Apple&nbsp;iPhone&nbsp;16&nbsp;Pro&nbsp;256GB&nbsp;Natural&nbsp;Titanium&nbsp;5G&nbsp;Smartphone&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;brand&quot;:&nbsp;&quot;Apple&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;price_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;current_price&quot;:&nbsp;8999.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;original_price&quot;:&nbsp;9999.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;plus_price&quot;:&nbsp;8799.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;price_protection_days&quot;:&nbsp;7 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stock_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;total_stock&quot;:&nbsp;9600, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stock_status&quot;:&nbsp;&quot;in_stock&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;is_self_operated&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;delivery_tip&quot;:&nbsp;&quot;211限时达，当日上午10点前下单当日送达&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_list&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;sub_sku_id&quot;:&nbsp;100012345679,&nbsp;&quot;spec&quot;:&nbsp;&quot;Natural&nbsp;Titanium&nbsp;/&nbsp;256GB&quot;,&nbsp;&quot;sku_price&quot;:&nbsp;8999.00,&nbsp;&quot;sku_stock&quot;:&nbsp;5200}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;sub_sku_id&quot;:&nbsp;100012345680,&nbsp;&quot;spec&quot;:&nbsp;&quot;Black&nbsp;Titanium&nbsp;/&nbsp;512GB&quot;,&nbsp;&quot;sku_price&quot;:&nbsp;9999.00,&nbsp;&quot;sku_stock&quot;:&nbsp;4400} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;images&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;main_image&quot;:&nbsp;&quot;https://img14.360buyimg.com/n1/xxx.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;gallery&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img14.360buyimg.com/n1/1.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img14.360buyimg.com/n1/2.jpg&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;shop_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;shop_name&quot;:&nbsp;&quot;Apple京东自营官方旗舰店&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;shop_type&quot;:&nbsp;&quot;自营&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} }</pre><hr/><p data-track="151">需要我给你提供<strong>极简版Python调用代码</strong>，直接填入密钥就能发起请求拿到结构化商品数据吗？</p><p><br/></p><p><br/></p>Sat, 10 Oct 2026 14:35:08 +0800https://apiceshiwang.com/?id=205<h1 spellcheck="false" class="pgc-h-forward-slash" data-track="1" data-pm-slice="1 1 []"><span style="font-size: 14px;">Introduction</span></h1><p data-track="3"><plcensor id="plcensor-120" data-origin="" ignoretag="true">Taobao, as the largest consumer e-commerce marketplace in China, hosts hundreds of millions of mature, high-demand products that are ideal sources of goods for domestic multi-store operations, cross-border reselling, and private domain e-commerce businesses. Manually copying product titles, images, prices and SKU details from Taobao to other storefronts is not only extremely time-consuming, but also prone to human errors that lead to inconsistent inventory, mismatched SKU specifications and non-compliant listing content. The automated Taobao product detail listing workflow solves these pain points completely: it pulls full structured product data from official interfaces, automatically cleans platform-specific redundant content, processes images to bypass anti-hotlinking restrictions, and outputs standardized data that can be directly mapped to target platforms for one-click listing. This guide breaks down the full end-to-end technical architecture, core data transformation rules, and provides a production-grade standard JSON reference for the final listing output.</plcensor></p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="4">1. Core Automated Listing Workflow</h1><p data-track="5">A production-ready Taobao product migration system follows 4 sequential, low-maintenance steps:</p><ol start="1" class=" list-paddingleft-2"><li><p><strong>Structured Data Pulling</strong>: Fetch complete product details via official taobao.item.get API, including title, price, SKU specifications, real-time stock, full description, and supplier information. No manual web scraping required to ensure long-term stability.</p></li><li><p><strong>Data Cleaning &amp; Transformation</strong>: Filter out Taobao-specific promotional text, platform watermarks, and invalid HTML tags, convert Taobao’s native SKU attribute structure to the format that matches the target platform’s category rules.</p></li><li><p><strong>Image Resource Processing</strong>: Automatically download all main images, gallery pictures and detail page images, remove Taobao’s anti-hotlinking parameters and watermarks, compress files to meet the target platform’s resolution and size limits.</p></li><li><p><strong>Validation &amp; One-Click Push</strong>: Run pre-submission compliance checks, map all standardized fields to the target marketplace’s API specification, submit the listing, and return the new store product ID for subsequent real-time inventory and price synchronization.</p></li></ol><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="10">2. Key Technical Rules for Taobao Data Migration</h1><p data-track="11">Taobao’s product data has several unique characteristics that must be handled specially before cross-platform listing:</p><ul class=" list-paddingleft-2"><li><p><strong>Price Normalization</strong>: Separate the original price, promotion price and activity flash sale price from Taobao’s complex price system, automatically calculate the final selling price with a pre-defined markup ratio, avoiding price display errors.</p></li><li><p><strong>SKU Structure Alignment</strong>: Parse Taobao’s native semi-colon separated SKU property string (such as &quot;color:red;size:M&quot;) into independent key-value attribute pairs that are compatible with most mainstream e-commerce platforms.</p></li><li><p><strong>Description Purification</strong>: Strip out Taobao’s dedicated interactive elements, store coupon pop-ups and platform-specific links from the HTML description, to prevent the listing from being rejected by the target platform.</p></li><li><p><strong>Image Anti-Hotlinking Bypass</strong>: Replace all Taobao CDN image URLs with links hosted on your own independent object storage, to avoid broken images caused by Taobao’s anti-leech policy.</p></li></ul><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="16">3. Standard Structured Output JSON Reference</h1><p class="pgc-p" data-track="17">Below is the final standardized listing JSON that has completed all data cleaning and transformation, which can be directly mapped to Shopify, WooCommerce, local domestic e-commerce platforms and other target systems without additional manual editing:</p><p class="pgc-p" data-track="289">Use the website: o0b.cn/anzexi</p><pre language="javascript" code_block="true">{ &nbsp;&nbsp;&quot;listing_task_id&quot;:&nbsp;&quot;taobao_list_20260921093517007&quot;, &nbsp;&nbsp;&quot;source_context&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;source_platform&quot;:&nbsp;&quot;Taobao&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;source_item_id&quot;:&nbsp;&quot;723456189012&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;source_item_url&quot;:&nbsp;&quot;https://item.taobao.com/item.htm?id=723456189012&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;taobao_shop_name&quot;:&nbsp;&quot;Official&nbsp;Fashion&nbsp;Apparel&nbsp;Flagship&nbsp;Store&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;original_shop_type&quot;:&nbsp;&quot;Tmall&nbsp;Official&nbsp;Store&quot; &nbsp;&nbsp;}, &nbsp;&nbsp;&quot;standardized_listing_data&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;target_platform&quot;:&nbsp;&quot;Private&nbsp;Domain&nbsp;Mini&nbsp;Program&nbsp;Store&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;target_product_title&quot;:&nbsp;&quot;100%&nbsp;Cotton&nbsp;Oversized&nbsp;Casual&nbsp;Hoodie&nbsp;Men&nbsp;Autumn&nbsp;Winter&nbsp;Loose&nbsp;Pullover&nbsp;Couple&nbsp;Sweatshirt&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;target_category_id&quot;:&nbsp;&quot;127&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;brand_name&quot;:&nbsp;&quot;UrbanBasic&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;price_config&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;taobao_cost_price&quot;:&nbsp;129.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;markup_ratio&quot;:&nbsp;1.5, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;final_regular_price&quot;:&nbsp;199.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;original_market_price&quot;:&nbsp;259.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;currency&quot;:&nbsp;&quot;CNY&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;tax_included&quot;:&nbsp;true &nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&quot;inventory_sync&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;taobao_real_time_stock&quot;:&nbsp;23600, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;available_sale_stock&quot;:&nbsp;23600, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;oversell_protect_threshold&quot;:&nbsp;30 &nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&quot;product_description&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;key_selling_points&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;100%&nbsp;high&nbsp;quality&nbsp;cotton&nbsp;fabric,&nbsp;soft&nbsp;and&nbsp;skin-friendly&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;Oversized&nbsp;loose&nbsp;cut,&nbsp;suitable&nbsp;for&nbsp;all&nbsp;body&nbsp;shapes&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;Thickened&nbsp;fleece&nbsp;inner&nbsp;layer,&nbsp;warm&nbsp;for&nbsp;autumn&nbsp;and&nbsp;winter&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;No&nbsp;pilling,&nbsp;no&nbsp;fading&nbsp;after&nbsp;repeated&nbsp;washing&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;cleaned_description_html&quot;:&nbsp;&quot;&lt;p&gt;Made&nbsp;of&nbsp;32S&nbsp;combed&nbsp;cotton,&nbsp;this&nbsp;hoodie&nbsp;offers&nbsp;long-lasting&nbsp;comfort...&lt;/p&gt;&quot; &nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&quot;product_attributes&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attribute_name&quot;:&nbsp;&quot;Fabric&quot;,&nbsp;&quot;attribute_value&quot;:&nbsp;&quot;100%&nbsp;Cotton&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attribute_name&quot;:&nbsp;&quot;Style&quot;,&nbsp;&quot;attribute_value&quot;:&nbsp;&quot;Casual&nbsp;/&nbsp;Streetwear&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attribute_name&quot;:&nbsp;&quot;Applicable&nbsp;Season&quot;,&nbsp;&quot;attribute_value&quot;:&nbsp;&quot;Autumn&nbsp;/&nbsp;Winter&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attribute_name&quot;:&nbsp;&quot;Washing&nbsp;Tips&quot;,&nbsp;&quot;attribute_value&quot;:&nbsp;&quot;Machine&nbsp;wash&nbsp;below&nbsp;30℃,&nbsp;reverse&nbsp;washing&nbsp;recommended&quot;} &nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_variant_list&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_sku_id&quot;:&nbsp;&quot;sku_001&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_full_name&quot;:&nbsp;&quot;Color:&nbsp;Black;&nbsp;Size:&nbsp;M&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_sale_price&quot;:&nbsp;199.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_stock&quot;:&nbsp;4200, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_image_index&quot;:&nbsp;1 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_sku_id&quot;:&nbsp;&quot;sku_002&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_full_name&quot;:&nbsp;&quot;Color:&nbsp;Light&nbsp;Grey;&nbsp;Size:&nbsp;L&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_sale_price&quot;:&nbsp;199.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_stock&quot;:&nbsp;3800, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_image_index&quot;:&nbsp;2 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_sku_id&quot;:&nbsp;&quot;sku_003&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_full_name&quot;:&nbsp;&quot;Color:&nbsp;White;&nbsp;Size:&nbsp;XL&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_sale_price&quot;:&nbsp;199.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_stock&quot;:&nbsp;3100, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_image_index&quot;:&nbsp;3 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&quot;processed_media_resources&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;main_image_url&quot;:&nbsp;&quot;https://your-own-oss.com/apparel/hoodie_main_001.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;gallery_image_urls&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://your-own-oss.com/apparel/hoodie_1.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://your-own-oss.com/apparel/hoodie_2.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://your-own-oss.com/apparel/hoodie_3.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://your-own-oss.com/apparel/hoodie_4.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://your-own-oss.com/apparel/hoodie_detail.jpg&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;local_hosted_video_url&quot;:&nbsp;&quot;https://your-own-oss.com/video/hoodie_showcase.mp4&quot; &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;}, &nbsp;&nbsp;&quot;pre_submission_validation&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;validation_passed&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&quot;warning_items&quot;:&nbsp;[], &nbsp;&nbsp;&nbsp;&nbsp;&quot;blocking_error&quot;:&nbsp;null &nbsp;&nbsp;} }</pre><p data-track="19"><br/></p><p><br/></p>Thu, 08 Oct 2026 15:45:18 +0800https://apiceshiwang.com/?id=204<h1 spellcheck="false" class="pgc-h-forward-slash" data-track="1" data-pm-slice="1 1 []"><span style="font-size: 14px;">Introduction</span></h1><p data-track="3"><plcensor id="plcensor-119" data-origin="" ignoretag="true">1688.com, Alibaba’s leading B2B wholesale marketplace, is the primary global sourcing hub for dropshippers, cross-border e-commerce sellers, and small-to-medium retailers. For operational teams, manually copying product details from 1688 to their own storefronts (Shopify, WooCommerce, Temu, local marketplaces) is highly inefficient, error-prone, and cannot keep up with fast-changing wholesale prices and inventory levels. The official 1688 product detail scraping and listing automation workflow solves this pain point: it extracts structured, standardized product data in real time, automatically cleans and transforms fields, and pushes qualified product information directly to target platforms for one-click listing. This guide breaks down the full end-to-end technical workflow, core transformation rules, and provides a production-grade standard JSON reference for the standardized listing output.</plcensor></p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="4">1. Core Workflow Overview</h1><p data-track="5">A production-ready 1688 product listing automation system follows 4 key steps, no manual data entry required:</p><ol start="1" class=" list-paddingleft-2"><li><p><strong>Data Pulling</strong>: Fetch full structured product details from 1688 via official API or authorized data access solution, including titles, tiered prices, SKU specs, stock, images, and supplier information.</p></li><li><p><strong>Data Cleaning &amp; Transformation</strong>: Remove 1688-specific watermarks, filter redundant marketing text, convert Chinese attributes to multi-language fields that match the target platform’s category rules.</p></li><li><p><strong>Image Processing</strong>: Automatically download product images, remove 1688 platform logos and watermarks, compress files to meet the target platform’s image size and resolution requirements.</p></li><li><p><strong>Listing Push</strong>: Map the standardized final data to the target marketplace’s API fields, submit the listing, and return the new store product ID for subsequent inventory synchronization.</p></li></ol><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="10">2. Key Technical Rules for 1688 Data Migration</h1><p data-track="11">Unlike B2C consumer platforms, 1688’s product data has unique B2B attributes that must be handled specially before listing:</p><ul class=" list-paddingleft-2"><li><p><strong>Tiered Price Mapping</strong>: 1688’s bulk tiered pricing must be converted to the target platform’s regular retail price, with a pre-defined markup ratio applied automatically.</p></li><li><p><strong>MOQ Adjustment</strong>: 1688’s Minimum Order Quantity (MOQ) is usually 2 or 10, which is not suitable for retail scenarios. The system can automatically adjust the minimum order quantity to 1 for end customers.</p></li><li><p><strong>Supplier Attribute Filtering</strong>: Remove supplier-specific contact information and 1688 platform promotional text from the description, to avoid violating the target marketplace’s listing rules.</p></li><li><p><strong>Inventory Calibration</strong>: Synchronize 1688’s real-time wholesale stock to the retail store, and automatically mark the product as out of stock if 1688 available quantity drops below the pre-set threshold.</p></li></ul><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="16">3. Standard Structured Output JSON Reference</h1><p class="pgc-p" data-track="17">Below is the final standardized listing JSON that can be directly mapped to most mainstream e-commerce platforms. This structure has completed all 1688 data cleaning and transformation, and can be submitted to the target marketplace API without additional manual editing:</p><p class="pgc-p" data-track="266">Use the website: o0b.cn/anzexi</p><pre language="javascript" code_block="true">{ &nbsp;&nbsp;&quot;task_id&quot;:&nbsp;&quot;1688_list_20260920142233001&quot;, &nbsp;&nbsp;&quot;source_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;source_platform&quot;:&nbsp;&quot;1688&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;source_product_id&quot;:&nbsp;&quot;678901234567&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;source_product_url&quot;:&nbsp;&quot;https://detail.1688.com/offer/678901234567.html&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;supplier_name&quot;:&nbsp;&quot;Shenzhen&nbsp;Outdoor&nbsp;Tech&nbsp;Co.,&nbsp;Ltd.&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;original_supplier_moq&quot;:&nbsp;2 &nbsp;&nbsp;}, &nbsp;&nbsp;&quot;target_listing_data&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;target_platform&quot;:&nbsp;&quot;Shopify&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;target_product_title&quot;:&nbsp;&quot;1000W&nbsp;Portable&nbsp;1024Wh&nbsp;Solar&nbsp;Power&nbsp;Station&nbsp;Outdoor&nbsp;Camping&nbsp;Emergency&nbsp;Generator&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;category_id&quot;:&nbsp;&quot;283&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;brand&quot;:&nbsp;&quot;OutdoorPower&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;retail_price_rule&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;base_cost&quot;:&nbsp;550, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;markup_ratio&quot;:&nbsp;1.8, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;final_regular_price&quot;:&nbsp;999, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;compare_at_price&quot;:&nbsp;1199, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;currency&quot;:&nbsp;&quot;USD&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;min_order_quantity&quot;:&nbsp;1 &nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&quot;inventory_sync&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;source_1688_stock&quot;:&nbsp;12600, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;available_retail_stock&quot;:&nbsp;12600, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;low_stock_alert_threshold&quot;:&nbsp;50 &nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&quot;product_description&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;short_bullets&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;1024Wh&nbsp;Large&nbsp;Capacity&nbsp;Battery&nbsp;for&nbsp;12+&nbsp;hours&nbsp;outdoor&nbsp;power&nbsp;supply&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;1000W&nbsp;Continuous&nbsp;Output,&nbsp;supports&nbsp;AC&nbsp;/&nbsp;USB-C&nbsp;/&nbsp;DC&nbsp;multi&nbsp;ports&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;100W&nbsp;Solar&nbsp;Panel&nbsp;Compatible,&nbsp;fast&nbsp;charging&nbsp;in&nbsp;6-8&nbsp;hours&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;Certified&nbsp;by&nbsp;CE,&nbsp;FCC,&nbsp;RoHS&nbsp;for&nbsp;global&nbsp;safety&nbsp;standards&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;full_description_html&quot;:&nbsp;&quot;&lt;p&gt;Built&nbsp;for&nbsp;outdoor&nbsp;camping,&nbsp;home&nbsp;emergency&nbsp;backup&nbsp;and&nbsp;RV&nbsp;travel...&lt;/p&gt;&quot; &nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&quot;spec_attributes&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;Battery&nbsp;Capacity&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;1024Wh&nbsp;LiFePO4&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;Rated&nbsp;Power&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;1000W&nbsp;Continuous&nbsp;/&nbsp;2000W&nbsp;Peak&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;Net&nbsp;Weight&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;12.5&nbsp;kg&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;name&quot;:&nbsp;&quot;Warranty&quot;,&nbsp;&quot;value&quot;:&nbsp;&quot;12&nbsp;Months&nbsp;Global&nbsp;Warranty&quot;} &nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_variants&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_id&quot;:&nbsp;&quot;sku_001&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_title&quot;:&nbsp;&quot;Standard&nbsp;Version&nbsp;(No&nbsp;Solar&nbsp;Panel)&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;price&quot;:&nbsp;999, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_stock&quot;:&nbsp;7200, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_image_index&quot;:&nbsp;0 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_id&quot;:&nbsp;&quot;sku_002&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;variant_title&quot;:&nbsp;&quot;Pro&nbsp;Version&nbsp;(With&nbsp;100W&nbsp;Foldable&nbsp;Solar&nbsp;Panel)&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;price&quot;:&nbsp;1299, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_stock&quot;:&nbsp;5400, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_image_index&quot;:&nbsp;4 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&quot;processed_media&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;main_image&quot;:&nbsp;&quot;https://your-oss-domain.com/product/powerstation_main.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;gallery_images&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://your-oss-domain.com/product/powerstation_1.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://your-oss-domain.com/product/powerstation_2.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://your-oss-domain.com/product/powerstation_3.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://your-oss-domain.com/product/powerstation_4.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://your-oss-domain.com/product/powerstation_solar.jpg&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;local_video_url&quot;:&nbsp;&quot;https://your-oss-domain.com/video/powerstation_demo.mp4&quot; &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;}, &nbsp;&nbsp;&quot;validation_result&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;pass_check&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&quot;warning_count&quot;:&nbsp;0, &nbsp;&nbsp;&nbsp;&nbsp;&quot;error_message&quot;:&nbsp;null &nbsp;&nbsp;} }</pre><p><br/></p><p><br/></p>Tue, 29 Sep 2026 17:17:51 +0800https://apiceshiwang.com/?id=203<h1 spellcheck="false" class="pgc-h-forward-slash" data-track="1" data-pm-slice="1 1 []" style="text-align: center;"><span style="font-size: 14px;">Introduction</span></h1><p data-track="3"><plcensor id="plcensor-101" data-origin="" ignoretag="true">As one of China’s largest and most trusted e-commerce ecosystems, JD.com operates a robust open API platform that powers millions of merchant ERP systems, supply chain management tools, and third-party data integration workflows. The official product detail interface is the core technical gateway for developers to access structured, real-time SKU data, covering JD’s unique logistics system, tiered pricing rules, and official inventory synchronization logic. Unlike generic web scraping solutions, this official RESTful API guarantees data accuracy, anti-scraping stability, and full compliance with JD’s developer terms, making it the industry standard for production-level B2C and B2B e-commerce integration. This guide breaks down the full technical architecture, mandatory request parameters, and provides a production-grade standard JSON response reference to help developers quickly build stable JD data integration pipelines.</plcensor></p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="4">1. Core Interface Basic Information</h1><p data-track="5">The JD Product Detail API is a high-performance RESTful service hosted on JD’s global open platform infrastructure, optimized for high-frequency commercial data access scenarios.</p><table><tbody><tr class="firstRow"><td><p data-track="8">Item</p></td><td><p data-track="9">Specification</p></td></tr><tr><td><p data-track="10">Official API Name</p></td><td><p data-track="11">jd.product.detail.get (Get Full JD Product Details)</p></td></tr><tr><td><p data-track="12">Communication Protocol</p></td><td><p data-track="13">HTTPS POST (Recommended) / GET</p></td></tr><tr><td><p data-track="14">Default Data Format</p></td><td><p data-track="15">JSON</p></td></tr><tr><td><p data-track="16">Official Gateway Endpoint</p></td><td><p data-track="17">https://api.jd.com/routerjson</p></td></tr><tr><td><p data-track="18">Authentication Mechanism</p></td><td><p data-track="19">AppKey + AppSecret + OAuth 2.0 AccessToken + MD5 Signature</p></td></tr><tr><td><p data-track="20">Typical Use Cases</p></td><td><p data-track="21">JD store product synchronization, real-time price monitoring, inventory status verification, Jingdong Logistics distribution pre-estimation, competitor analysis and selection</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="22">2. Full Request Parameter Breakdown</h1><p data-track="23">Calling this API strictly follows JD Open Platform’s official TOP-style signature specification. All non-empty parameters must be sorted lexicographically and encrypted with the AppSecret to generate a valid, tamper-proof signature value.</p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="24">2.1 Mandatory Public Gateway Parameters</h1><p data-track="25">These parameters are required for every JD API call, used for platform authentication, permission validation and request tracing:</p><table><tbody><tr class="firstRow"><td><p data-track="28">Parameter Name</p></td><td><p data-track="29">Type</p></td><td><p data-track="30">Required</p></td><td><p data-track="31">Description</p></td></tr><tr><td><p data-track="32">app_key</p></td><td><p data-track="33">String</p></td><td><p data-track="34">Yes</p></td><td><p data-track="35">Unique application identifier, obtained after enterprise developer verification on JD Open Platform</p></td></tr><tr><td><p data-track="36">method</p></td><td><p data-track="37">String</p></td><td><p data-track="38">Yes</p></td><td><p data-track="39">Fixed as</p><p data-track="40"><br/></p><p data-track="41">jd.product.detail.get</p><p data-track="42"><br/></p><p data-track="43">to specify the target product detail interface</p></td></tr><tr><td><p data-track="44">access_token</p></td><td><p data-track="45">String</p></td><td><p data-track="46">Yes</p></td><td><p data-track="47">OAuth 2.0 authorized token, which carries the requester’s permission scope (public data / merchant exclusive operation permission)</p></td></tr><tr><td><p data-track="48">timestamp</p></td><td><p data-track="49">String</p></td><td><p data-track="50">Yes</p></td><td><p data-track="51">East 8 timezone timestamp formatted as</p><p data-track="52"><br/></p><p data-track="53">yyyy-MM-dd HH:mm:ss, used to prevent replay attacks</p></td></tr><tr><td><p data-track="54">v</p></td><td><p data-track="55">String</p></td><td><p data-track="56">Yes</p></td><td><p data-track="57">API protocol version, the current stable production version is</p><p data-track="58"><br/></p><p data-track="59">1.0</p></td></tr><tr><td><p data-track="60">sign_method</p></td><td><p data-track="61">String</p></td><td><p data-track="62">Yes</p></td><td><p data-track="63">Signature algorithm,</p><p data-track="64"><br/></p><p data-track="65">md5</p><p data-track="66"><br/></p><p data-track="67">is the platform standard for all open interfaces</p></td></tr><tr><td><p data-track="68">sign</p></td><td><p data-track="69">String</p></td><td><p data-track="70">Yes</p></td><td><p data-track="71">Final encrypted signature value generated by AppSecret and sorted parameters</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="72">2.2 Business Core Parameters</h1><p data-track="73">These parameters control the granularity and scope of the JD product data returned:</p><table><tbody><tr class="firstRow"><td><p data-track="76">Parameter Name</p></td><td><p data-track="77">Type</p></td><td><p data-track="78">Required</p></td><td><p data-track="79">Description</p></td></tr><tr><td><p data-track="80">skuId</p></td><td><p data-track="81">Long</p></td><td><p data-track="82">Yes</p></td><td><p data-track="83">JD unique SKU ID, extracted directly from the product detail page URL</p></td></tr><tr><td><p data-track="84">fields</p></td><td><p data-track="85">String</p></td><td><p data-track="86">Yes</p></td><td><p data-track="87">Custom return field list, for example</p><p data-track="88"><br/></p><p data-track="89">skuId,name,price,stock. Explicitly specifying required fields can reduce response latency by over 35%</p></td></tr><tr><td><p data-track="90">needJdLogistics</p></td><td><p data-track="91">Boolean</p></td><td><p data-track="92">No</p></td><td><p data-track="93">Default</p><p data-track="94"><br/></p><p data-track="95">false. Set to</p><p data-track="96"><br/></p><p data-track="97">true</p><p data-track="98"><br/></p><p data-track="99">to return real-time JD self-operated warehouse stock distribution and 211 time-limited delivery information</p></td></tr><tr><td><p data-track="100">needPromotion</p></td><td><p data-track="101">Boolean</p></td><td><p data-track="102">No</p></td><td><p data-track="103">Default</p><p data-track="104"><br/></p><p data-track="105">false. Set to</p><p data-track="106"><br/></p><p data-track="107">true</p><p data-track="108"><br/></p><p data-track="109">to pull all ongoing flash sale, coupon and full reduction activity data of the product</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="110">3. Standard Production JSON Response Reference</h1><p class="pgc-p" data-track="111">Below is a standard full JSON response that strictly follows JD’s official interface return specification. This structure includes all unique high-value fields of JD’s e-commerce system, and can be directly used for debugging and enterprise system docking:</p><p class="pgc-p" data-track="420">Use the website: o0b.cn/anzexi</p><pre language="javascript" code_block="true">{ &nbsp;&nbsp;&quot;jd_product_detail_get_response&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;code&quot;:&nbsp;0, &nbsp;&nbsp;&nbsp;&nbsp;&quot;msg&quot;:&nbsp;&quot;success&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;request_id&quot;:&nbsp;&quot;jd_req_20260919113044789&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;data&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_id&quot;:&nbsp;100012345678, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;spu_id&quot;:&nbsp;100087654321, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;name&quot;:&nbsp;&quot;Apple&nbsp;MacBook&nbsp;Pro&nbsp;14-inch&nbsp;M4&nbsp;Pro&nbsp;Chip&nbsp;18GB&nbsp;RAM&nbsp;512GB&nbsp;SSD&nbsp;Space&nbsp;Black&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;brand_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;brand_id&quot;:&nbsp;1342, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;brand_name&quot;:&nbsp;&quot;Apple&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;is_self_operated_brand&quot;:&nbsp;true &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;price_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;current_price&quot;:&nbsp;14999.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;original_price&quot;:&nbsp;16999.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;discount_rate&quot;:&nbsp;12, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;currency&quot;:&nbsp;&quot;CNY&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;is_jd_price_protection&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;promotion_list&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;promotion_type&quot;:&nbsp;&quot;full_reduction&quot;,&nbsp;&quot;desc&quot;:&nbsp;&quot;Minus&nbsp;500&nbsp;when&nbsp;order&nbsp;over&nbsp;10000&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;promotion_type&quot;:&nbsp;&quot;coupon&quot;,&nbsp;&quot;desc&quot;:&nbsp;&quot;Exclusive&nbsp;200&nbsp;yuan&nbsp;coupon&nbsp;for&nbsp;PLUS&nbsp;members&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stock_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;total_available_stock&quot;:&nbsp;8600, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stock_status&quot;:&nbsp;&quot;in_stock&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;is_jd_self_operated&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;warehouse_distribution&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;warehouse_code&quot;:&nbsp;&quot;BJ001&quot;,&nbsp;&quot;city&quot;:&nbsp;&quot;Beijing&quot;,&nbsp;&quot;stock&quot;:&nbsp;3200,&nbsp;&quot;delivery_type&quot;:&nbsp;&quot;211_timeline&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;warehouse_code&quot;:&nbsp;&quot;SH002&quot;,&nbsp;&quot;city&quot;:&nbsp;&quot;Shanghai&quot;,&nbsp;&quot;stock&quot;:&nbsp;2800,&nbsp;&quot;delivery_type&quot;:&nbsp;&quot;211_timeline&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;warehouse_code&quot;:&nbsp;&quot;GZ003&quot;,&nbsp;&quot;city&quot;:&nbsp;&quot;Guangzhou&quot;,&nbsp;&quot;stock&quot;:&nbsp;2600,&nbsp;&quot;delivery_type&quot;:&nbsp;&quot;next_day&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specifications&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attr_name&quot;:&nbsp;&quot;Screen&nbsp;Size&quot;,&nbsp;&quot;attr_value&quot;:&nbsp;&quot;14.2&nbsp;inches&nbsp;Liquid&nbsp;Retina&nbsp;XDR&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attr_name&quot;:&nbsp;&quot;Chip&quot;,&nbsp;&quot;attr_value&quot;:&nbsp;&quot;Apple&nbsp;M4&nbsp;Pro&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attr_name&quot;:&nbsp;&quot;Memory&quot;,&nbsp;&quot;attr_value&quot;:&nbsp;&quot;18&nbsp;GB&nbsp;Unified&nbsp;Memory&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attr_name&quot;:&nbsp;&quot;Storage&quot;,&nbsp;&quot;attr_value&quot;:&nbsp;&quot;512&nbsp;GB&nbsp;SSD&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attr_name&quot;:&nbsp;&quot;Warranty&quot;,&nbsp;&quot;attr_value&quot;:&nbsp;&quot;1&nbsp;Year&nbsp;Official&nbsp;Warranty&nbsp;+&nbsp;JD&nbsp;Home&nbsp;On-site&nbsp;Service&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_list&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sub_sku_id&quot;:&nbsp;100012345679, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;spec_text&quot;:&nbsp;&quot;Space&nbsp;Black&nbsp;/&nbsp;18GB&nbsp;/&nbsp;512GB&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_price&quot;:&nbsp;14999.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_stock&quot;:&nbsp;4500 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sub_sku_id&quot;:&nbsp;100012345680, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;spec_text&quot;:&nbsp;&quot;Silver&nbsp;/&nbsp;24GB&nbsp;/&nbsp;1TB&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_price&quot;:&nbsp;18999.00, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_stock&quot;:&nbsp;4100 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;media_resources&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;main_image&quot;:&nbsp;&quot;https://img14.360buyimg.com/n1/jfs/t1/xxx/main.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;image_gallery&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img14.360buyimg.com/n1/jfs/t1/xxx/1.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img14.360buyimg.com/n1/jfs/t1/xxx/2.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img14.360buyimg.com/n1/jfs/t1/xxx/3.jpg&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;detail_video&quot;:&nbsp;&quot;https://cdn.jd.com/video/play/xxx.mp4&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;service_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;support_jd_installment&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;support_jd_delivery&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;return_policy&quot;:&nbsp;&quot;7&nbsp;days&nbsp;no&nbsp;reason&nbsp;return,&nbsp;15&nbsp;days&nbsp;exchange&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;warranty_service&quot;:&nbsp;&quot;JD&nbsp;Home&nbsp;On-site&nbsp;Support&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} }</pre><p data-track="113"><br/></p><p><br/></p>Mon, 28 Sep 2026 15:35:27 +0800https://apiceshiwang.com/?id=202<h1 spellcheck="false" class="pgc-h-forward-slash" data-track="1" data-pm-slice="1 1 []"><span style="font-size: 14px;">Introduction</span></h1><p data-track="3"><plcensor id="plcensor-103" data-origin="" ignoretag="true">1688.com, Alibaba’s flagship B2B wholesale marketplace, serves as the core supply chain hub for millions of global retailers, dropshippers, and enterprise procurement teams. Unlike consumer-facing e-commerce platforms, its open API ecosystem is purpose-built for bulk product sourcing, tiered price negotiation, supplier management, and automated B2B order fulfillment. The official product detail interface (part of the 1688 Open Platform suite) is the foundational technical gateway that enables third-party ERP systems, sourcing tools, and cross-border reselling platforms to access structured, real-time wholesale product data. This guide breaks down the full technical architecture, mandatory request parameters, and provides a production-grade standard JSON response reference to help developers build stable, compliant 1688 data integration pipelines.</plcensor></p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="4">1. Core Interface Basic Information</h1><p data-track="5">The 1688 Product Detail API is a production-grade RESTful service hosted on Alibaba’s B2B open platform infrastructure, optimized for high-frequency industrial and wholesale business scenarios.</p><table><tbody><tr class="firstRow"><td><p data-track="8">Item</p></td><td><p data-track="9">Specification</p></td></tr><tr><td><p data-track="10">Official API Name</p></td><td><p data-track="11">alibaba.product.get (Get Full Wholesale Product Details)</p></td></tr><tr><td><p data-track="12">Communication Protocol</p></td><td><p data-track="13">HTTPS POST (Recommended) / GET</p></td></tr><tr><td><p data-track="14">Default Data Format</p></td><td><p data-track="15">JSON (XML is supported for legacy enterprise ERP systems)</p></td></tr><tr><td><p data-track="16">Official Gateway Endpoint</p></td><td><p data-track="17">https://gw.open.1688.com/openapi</p></td></tr><tr><td><p data-track="18">Authentication Mechanism</p></td><td><p data-track="19">AppKey + AppSecret + OAuth 2.0 AccessToken + HMAC-SHA1 Signature</p></td></tr><tr><td><p data-track="20">Typical Use Cases</p></td><td><p data-track="21">Wholesale product sourcing, tiered price monitoring, supplier qualification verification, dropshipping inventory synchronization, cross-border e-commerce product listing automation</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="22">2. Full Request Parameter Breakdown</h1><p data-track="23">Calling this API strictly follows 1688 Open Platform’s proprietary signature specification. All non-empty parameters must be sorted lexicographically and encrypted with the AppSecret to generate a valid, tamper-proof signature value.</p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="24">2.1 Mandatory Public Gateway Parameters</h1><p data-track="25">These parameters are required for every 1688 API call, used for platform authentication, permission validation and request tracing:</p><table><tbody><tr class="firstRow"><td><p data-track="28">Parameter Name</p></td><td><p data-track="29">Type</p></td><td><p data-track="30">Required</p></td><td><p data-track="31">Description</p></td></tr><tr><td><p data-track="32">app_key</p></td><td><p data-track="33">String</p></td><td><p data-track="34">Yes</p></td><td><p data-track="35">Unique application identifier, obtained after enterprise developer verification on 1688 Open Platform</p></td></tr><tr><td><p data-track="36">method</p></td><td><p data-track="37">String</p></td><td><p data-track="38">Yes</p></td><td><p data-track="39">Fixed as</p><p data-track="40"><br/></p><p data-track="41">alibaba.product.get</p><p data-track="42"><br/></p><p data-track="43">to specify the target product detail interface</p></td></tr><tr><td><p data-track="44">access_token</p></td><td><p data-track="45">String</p></td><td><p data-track="46">Yes</p></td><td><p data-track="47">OAuth 2.0 authorized token, which carries the requester’s permission scope (public data / enterprise exclusive price)</p></td></tr><tr><td><p data-track="48">timestamp</p></td><td><p data-track="49">String</p></td><td><p data-track="50">Yes</p></td><td><p data-track="51">East 8 timezone timestamp formatted as</p><p data-track="52"><br/></p><p data-track="53">yyyy-MM-dd HH:mm:ss, used to prevent replay attacks</p></td></tr><tr><td><p data-track="54">v</p></td><td><p data-track="55">String</p></td><td><p data-track="56">Yes</p></td><td><p data-track="57">API protocol version, the current stable production version is</p><p data-track="58"><br/></p><p data-track="59">2.0</p></td></tr><tr><td><p data-track="60">sign_method</p></td><td><p data-track="61">String</p></td><td><p data-track="62">Yes</p></td><td><p data-track="63">Signature algorithm,</p><p data-track="64"><br/></p><p data-track="65">hmac-sha1</p><p data-track="66"><br/></p><p data-track="67">is the platform standard for all B2B interfaces</p></td></tr><tr><td><p data-track="68">sign</p></td><td><p data-track="69">String</p></td><td><p data-track="70">Yes</p></td><td><p data-track="71">Final encrypted signature value generated by AppSecret and sorted parameters</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="72">2.2 Business Core Parameters</h1><p data-track="73">These parameters control the granularity and scope of the wholesale product data returned:</p><table><tbody><tr class="firstRow"><td data-colwidth="88"><p data-track="76">Parameter Name</p></td><td><p data-track="77">Type</p></td><td><p data-track="78">Required</p></td><td><p data-track="79">Description</p></td></tr><tr><td data-colwidth="88"><p data-track="80">productId</p></td><td><p data-track="81">Long</p></td><td><p data-track="82">Yes</p></td><td><p data-track="83">1688 unique product ID (Offer ID), extracted directly from the product detail page URL</p></td></tr><tr><td data-colwidth="88"><p data-track="84">fields</p></td><td><p data-track="85">String</p></td><td><p data-track="86">Yes</p></td><td><p data-track="87">Custom return field list, for example</p><p data-track="88"><br/></p><p data-track="89">productId,title,price,sku,supplier. Explicitly specifying required fields can reduce response latency by over 40%</p></td></tr><tr><td data-colwidth="88"><p data-track="90">needCargoInfo</p></td><td><p data-track="91">Boolean</p></td><td><p data-track="92">No</p></td><td><p data-track="93">Default</p><p data-track="94"><br/></p><p data-track="95">false. Set to</p><p data-track="96"><br/></p><p data-track="97">true</p><p data-track="98"><br/></p><p data-track="99">to return real-time warehouse stock distribution and logistics delivery information</p></td></tr><tr><td data-colwidth="88"><p data-track="100">includeExclusivePrice</p></td><td><p data-track="101">Boolean</p></td><td><p data-track="102">No</p></td><td><p data-track="103">Default</p><p data-track="104"><br/></p><p data-track="105">false. Only authorized enterprise buyers can set this to</p><p data-track="106"><br/></p><p data-track="107">true</p><p data-track="108"><br/></p><p data-track="109">to view negotiated exclusive contract prices</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="110">3. Standard Production JSON Response Reference</h1><p class="pgc-p" data-track="111">Below is a standard full JSON response that strictly follows 1688’s official B2B interface return specification. This structure includes all unique high-value wholesale business fields, and can be directly used for debugging and enterprise ERP system docking:</p><p class="pgc-p" data-track="414">Use the website: o0b.cn/anzexi</p><pre language="javascript" code_block="true">{ &nbsp;&nbsp;&quot;alibaba_product_get_response&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;code&quot;:&nbsp;0, &nbsp;&nbsp;&nbsp;&nbsp;&quot;msg&quot;:&nbsp;&quot;success&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;request_id&quot;:&nbsp;&quot;1688_req_20260918102233456&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;data&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;product_id&quot;:&nbsp;678901234567, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;subject&quot;:&nbsp;&quot;Factory&nbsp;Direct&nbsp;1000W&nbsp;Portable&nbsp;Outdoor&nbsp;Power&nbsp;Station&nbsp;220V&nbsp;Solar&nbsp;Generator&nbsp;for&nbsp;Camping&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;supplier_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;member_id&quot;:&nbsp;&quot;123456789&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;company_name&quot;:&nbsp;&quot;Shenzhen&nbsp;New&nbsp;Energy&nbsp;Tech&nbsp;Co.,&nbsp;Ltd.&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;supplier_level&quot;:&nbsp;&quot;A+&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;gold_supplier_years&quot;:&nbsp;8, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;transaction_rate&quot;:&nbsp;&quot;98.5%&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;main_industry&quot;:&nbsp;&quot;Portable&nbsp;Power&nbsp;Station&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;price_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;unit&quot;:&nbsp;&quot;piece&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;currency&quot;:&nbsp;&quot;CNY&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;price_tiers&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;min_quantity&quot;:&nbsp;1,&nbsp;&quot;max_quantity&quot;:&nbsp;9,&nbsp;&quot;price&quot;:&nbsp;&quot;689.00&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;min_quantity&quot;:&nbsp;10,&nbsp;&quot;max_quantity&quot;:&nbsp;99,&nbsp;&quot;price&quot;:&nbsp;&quot;620.00&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;min_quantity&quot;:&nbsp;100,&nbsp;&quot;max_quantity&quot;:&nbsp;null,&nbsp;&quot;price&quot;:&nbsp;&quot;550.00&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;exclusive_contract_price&quot;:&nbsp;&quot;520.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;moq&quot;:&nbsp;1 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stock_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;total_available_stock&quot;:&nbsp;15600, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;stock_status&quot;:&nbsp;&quot;instock&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;warehouse_distribution&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;warehouse_code&quot;:&nbsp;&quot;SZ001&quot;,&nbsp;&quot;location&quot;:&nbsp;&quot;Shenzhen&quot;,&nbsp;&quot;stock&quot;:&nbsp;9200,&nbsp;&quot;lead_time_hours&quot;:&nbsp;48}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;warehouse_code&quot;:&nbsp;&quot;GZ002&quot;,&nbsp;&quot;location&quot;:&nbsp;&quot;Guangzhou&quot;,&nbsp;&quot;stock&quot;:&nbsp;6400,&nbsp;&quot;lead_time_hours&quot;:&nbsp;72} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;product_attrs&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attribute_name&quot;:&nbsp;&quot;Battery&nbsp;Capacity&quot;,&nbsp;&quot;attribute_value&quot;:&nbsp;&quot;1024Wh&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attribute_name&quot;:&nbsp;&quot;Rated&nbsp;Power&quot;,&nbsp;&quot;attribute_value&quot;:&nbsp;&quot;1000W&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attribute_name&quot;:&nbsp;&quot;Interface&nbsp;Type&quot;,&nbsp;&quot;attribute_value&quot;:&nbsp;&quot;USB-A&nbsp;/&nbsp;Type-C&nbsp;/&nbsp;AC&nbsp;Outlet&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;attribute_name&quot;:&nbsp;&quot;Certification&quot;,&nbsp;&quot;attribute_value&quot;:&nbsp;&quot;CE,&nbsp;FCC,&nbsp;RoHS,&nbsp;PSE&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_list&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_id&quot;:&nbsp;987654321001, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specification&quot;:&nbsp;&quot;Standard&nbsp;Version&nbsp;(No&nbsp;Solar&nbsp;Panel)&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_price&quot;:&nbsp;&quot;689.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_stock&quot;:&nbsp;8600 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_id&quot;:&nbsp;987654321002, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;specification&quot;:&nbsp;&quot;Pro&nbsp;Version&nbsp;(With&nbsp;100W&nbsp;Solar&nbsp;Panel)&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_price&quot;:&nbsp;&quot;899.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_stock&quot;:&nbsp;7000 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;media_resources&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;main_image&quot;:&nbsp;&quot;https://cbu01.alicdn.com/img/ibank/2026/xxx/1.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;image_gallery&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://cbu01.alicdn.com/img/ibank/2026/xxx/1.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://cbu01.alicdn.com/img/ibank/2026/xxx/2.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://cbu01.alicdn.com/img/ibank/2026/xxx/3.jpg&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;detail_video&quot;:&nbsp;&quot;https://cloud.video.1688.com/play/xxx.mp4&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;trade_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;payment_terms&quot;:&nbsp;&quot;T/T,&nbsp;L/C,&nbsp;Alibaba&nbsp;Trade&nbsp;Assurance&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;shipping_terms&quot;:&nbsp;&quot;FOB&nbsp;Shenzhen&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;supply_capability&quot;:&nbsp;&quot;50000&nbsp;pieces&nbsp;/&nbsp;Month&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;customization_support&quot;:&nbsp;true &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} }</pre><p><br/></p><p><br/></p>Wed, 23 Sep 2026 16:28:19 +0800https://apiceshiwang.com/?id=201<p data-track="267" data-pm-slice="1 1 []">Introduction</p><p data-track="3">As one of the world’s largest and most complex e-commerce ecosystems, Taobao (operated by Alibaba) powers millions of merchant operations, third-party ERP systems, and cross-platform data synchronization workflows. The taobao.item.get API, part of the Taobao Open Platform (TOP), serves as the core technical gateway for developers to access structured, real-time product data directly from the platform. Unlike generic public web scraping solutions, this official RESTful interface guarantees data accuracy, stability, and compliance with Alibaba’s developer rules, making it the industry-standard choice for production-level e-commerce integration.</p><p data-track="4">This guide breaks down the full technical architecture, mandatory request parameters, and provides a production-grade standard JSON response reference to help developers quickly build stable Taobao data integration pipelines.</p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="5">1. Core Interface Basic Information</h1><p data-track="6">The taobao.item.get interface is a production-grade RESTful service hosted on Alibaba’s global open platform gateway.</p><table><tbody><tr class="firstRow"><td><p data-track="9">Item</p></td><td><p data-track="10">Specification</p></td></tr><tr><td><p data-track="11">Official API Name</p></td><td><p data-track="12">taobao.item.get (Get Item Full Details)</p></td></tr><tr><td><p data-track="13">Communication Protocol</p></td><td><p data-track="14">HTTPS POST (Recommended) / GET</p></td></tr><tr><td><p data-track="15">Default Data Format</p></td><td><p data-track="16">JSON (XML is also supported for legacy systems)</p></td></tr><tr><td><p data-track="17">Official Gateway Endpoint</p></td><td><p data-track="18">https://eco.taobao.com/router/rest</p></td></tr><tr><td><p data-track="19">Authentication Mechanism</p></td><td><p data-track="20">AppKey + AppSecret + OAuth 2.0 SessionKey + HMAC-SHA256 Signature</p></td></tr><tr><td><p data-track="21">Typical Use Cases</p></td><td><p data-track="22">Product data synchronization, real-time price monitoring, inventory validation, third-party storefront reconstruction, product research and selection</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="23">2. Full Request Parameter Breakdown</h1><p data-track="24">Calling this API strictly follows Taobao Open Platform’s TOP signature specification. All non-empty parameters must be sorted lexicographically and encrypted with the AppSecret to generate a valid signature value.</p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="25">2.1 Mandatory Public Gateway Parameters</h1><p data-track="26">These parameters are required for every TOP API call, used for platform authentication and request tracing:</p><table><tbody><tr class="firstRow"><td data-colwidth="88"><p data-track="29">Parameter Name</p></td><td><p data-track="30">Type</p></td><td><p data-track="31">Required</p></td><td><p data-track="32">Description</p></td></tr><tr><td data-colwidth="88"><p data-track="33">app_key</p></td><td><p data-track="34">String</p></td><td><p data-track="35">Yes</p></td><td><p data-track="36">Unique application identifier, obtained after creating your developer account on Taobao Open Platform</p></td></tr><tr><td data-colwidth="88"><p data-track="37">method</p></td><td><p data-track="38">String</p></td><td><p data-track="39">Yes</p></td><td><p data-track="40">Fixed as</p><p data-track="41"><br/></p><p data-track="42">taobao.item.get</p><p data-track="43"><br/></p><p data-track="44">to specify the target interface</p></td></tr><tr><td data-colwidth="88"><p data-track="45">session</p></td><td><p data-track="46">String</p></td><td><p data-track="47">Yes</p></td><td><p data-track="48">OAuth 2.0 authorized SessionKey, represents the permission scope of the current requester</p></td></tr><tr><td data-colwidth="88"><p data-track="49">timestamp</p></td><td><p data-track="50">String</p></td><td><p data-track="51">Yes</p></td><td><p data-track="52">East 8 timezone timestamp, formatted as</p><p data-track="53"><br/></p><p data-track="54">yyyy-MM-dd HH:mm:ss, prevents replay attacks</p></td></tr><tr><td data-colwidth="88"><p data-track="55">v</p></td><td><p data-track="56">String</p></td><td><p data-track="57">Yes</p></td><td><p data-track="58">API protocol version, the stable version is</p><p data-track="59"><br/></p><p data-track="60">2.0</p></td></tr><tr><td data-colwidth="88"><p data-track="61">sign_method</p></td><td><p data-track="62">String</p></td><td><p data-track="63">Yes</p></td><td><p data-track="64">Signature algorithm,</p><p data-track="65"><br/></p><p data-track="66">hmac-sha256</p><p data-track="67"><br/></p><p data-track="68">is strongly recommended for security</p></td></tr><tr><td data-colwidth="88"><p data-track="69">sign</p></td><td><p data-track="70">String</p></td><td><p data-track="71">Yes</p></td><td><p data-track="72">Final encrypted signature value generated by AppSecret</p></td></tr><tr><td data-colwidth="88"><p data-track="73">format</p></td><td><p data-track="74">String</p></td><td><p data-track="75">No</p></td><td><p data-track="76">Response data format, default value is</p><p data-track="77"><br/></p><p data-track="78">json</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="79">2.2 Business Core Parameters</h1><p data-track="80">These parameters control the actual product data returned by the interface:</p><table><tbody><tr class="firstRow"><td data-colwidth="88"><p data-track="83">Parameter Name</p></td><td><p data-track="84">Type</p></td><td><p data-track="85">Required</p></td><td><p data-track="86">Description</p></td></tr><tr><td data-colwidth="88"><p data-track="87">num_iid</p></td><td><p data-track="88">Long</p></td><td><p data-track="89">Yes</p></td><td><p data-track="90">Taobao product digital ID, extracted directly from the product detail page URL</p></td></tr><tr><td data-colwidth="88"><p data-track="91">fields</p></td><td><p data-track="92">String</p></td><td><p data-track="93">Yes</p></td><td><p data-track="94">Custom return field list, for example</p><p data-track="95"><br/></p><p data-track="96">num_iid,title,price,sku. Explicitly specifying required fields can significantly reduce response latency</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="97">3. Standard Production JSON Response Reference</h1><p class="pgc-p" data-track="98">Below is a standard full JSON response that strictly follows Taobao’s official interface return specification. This structure includes all high-value business fields for e-commerce development, and can be directly used for debugging and system docking:</p><p class="pgc-p" data-track="268">Use the website: o0b.cn/anzexi</p><pre language="javascript" code_block="true">{ &nbsp;&nbsp;&quot;taobao_item_get_response&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;code&quot;:&nbsp;0, &nbsp;&nbsp;&nbsp;&nbsp;&quot;msg&quot;:&nbsp;&quot;success&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;request_id&quot;:&nbsp;&quot;tb_req_20260917094522107&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;item&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;num_iid&quot;:&nbsp;1003783113480, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;title&quot;:&nbsp;&quot;Apple&nbsp;iPhone&nbsp;16&nbsp;Pro&nbsp;256GB&nbsp;Titanium&nbsp;5G&nbsp;Dual&nbsp;SIM&nbsp;Smartphone&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;nick&quot;:&nbsp;&quot;Apple&nbsp;Tmall&nbsp;Official&nbsp;Flagship&nbsp;Store&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;cid&quot;:&nbsp;50012079, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;outer_id&quot;:&nbsp;&quot;APPLE-IP16PRO-256-TI&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;approve_status&quot;:&nbsp;&quot;onsale&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;total_stock&quot;:&nbsp;12600, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;current_price&quot;:&nbsp;&quot;8999.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;list_time&quot;:&nbsp;&quot;2026-09-10&nbsp;10:00:00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;delist_time&quot;:&nbsp;&quot;&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;detail_description&quot;:&nbsp;&quot;&lt;p&gt;New&nbsp;titanium&nbsp;design,&nbsp;A18&nbsp;Pro&nbsp;chip,&nbsp;leading&nbsp;performance&nbsp;experience...&lt;/p&gt;&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;main_pic_url&quot;:&nbsp;&quot;https://gd-hbimg.alicdn.com/imgextra/i1/O1CN01kLqZ7L1zqKzqKzqKz_!!6000000007239-2-tps-800-800.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;is_tmall_official&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_list&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_id&quot;:&nbsp;4567890123456, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;property_path&quot;:&nbsp;&quot;1627207:28349;1627209:28351&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;property_display&quot;:&nbsp;&quot;Color:&nbsp;Natural&nbsp;Titanium;&nbsp;Storage:&nbsp;256GB&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_price&quot;:&nbsp;&quot;8999.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;custom_outer_id&quot;:&nbsp;&quot;SKU-001&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_stock&quot;:&nbsp;3200 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_id&quot;:&nbsp;4567890123457, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;property_path&quot;:&nbsp;&quot;1627207:28350;1627209:28351&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;property_display&quot;:&nbsp;&quot;Color:&nbsp;White&nbsp;Titanium;&nbsp;Storage:&nbsp;256GB&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_price&quot;:&nbsp;&quot;8999.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;custom_outer_id&quot;:&nbsp;&quot;SKU-002&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_stock&quot;:&nbsp;2800 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;delivery_info&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;post_fee&quot;:&nbsp;&quot;0.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;express_fee&quot;:&nbsp;&quot;0.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;free_shipping_threshold&quot;:&nbsp;0 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;media_resources&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;product_images&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img.alicdn.com/imgextra/i1/1.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img.alicdn.com/imgextra/i2/2.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;https://img.alicdn.com/imgextra/i3/3.jpg&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;promo_video_url&quot;:&nbsp;&quot;https://cloud.video.taobao.com/play/u/123456/p/1/e/6/t/1/987654321.mp4&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} }</pre><p data-track="100"><br/></p><p><br/></p>Tue, 22 Sep 2026 15:10:16 +0800https://apiceshiwang.com/?id=200<h1 spellcheck="false" class="pgc-h-forward-slash" data-track="1" data-pm-slice="1 1 []">前言<br/></h1><p data-track="2">淘宝开放平台（TOP, Taobao Open Platform）的商品详情接口（taobao.item.get）是电商ERP、选品工具、多平台同步系统最核心的基础接口之一。该接口能够实时获取淘宝/天猫商品的标题、价格、库存、SKU规格、详情描述、图片资源等全维度结构化数据，是打通淘宝生态与自有业务系统的必备技术入口。</p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="3">一、接口核心基础信息</h1><p data-track="4">表格</p><table><tbody><tr class="firstRow"><td><p data-track="6">项目</p></td><td data-colwidth="414"><p data-track="7">说明</p></td></tr><tr><td><p data-track="8"><strong>接口名称</strong></p></td><td data-colwidth="414"><p data-track="9">获取商品详情 (taobao.item.get)</p></td></tr><tr><td><p data-track="10"><strong>请求协议</strong></p></td><td data-colwidth="414"><p data-track="11">HTTPS POST / GET</p></td></tr><tr><td><p data-track="12"><strong>数据格式</strong></p></td><td data-colwidth="414"><p data-track="13">JSON (推荐) 或 XML</p></td></tr><tr><td><p data-track="14"><strong>网关地址</strong></p></td><td data-colwidth="414"><p data-track="15">o0b.cn/anzexi</p></td></tr><tr><td><p data-track="16"><strong>鉴权方式</strong></p></td><td data-colwidth="414"><p data-track="17">AppKey + AppSecret + SessionKey (OAuth2.0) + Sign签名</p></td></tr><tr><td><p data-track="18"><strong>适用场景</strong></p></td><td data-colwidth="414"><p data-track="19">商品数据同步、价格监控、库存校验、详情页重构、选品分析</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="20">二、核心请求参数解析</h1><p data-track="21">调用淘宝API需严格遵循TOP签名规范，所有公共参数和业务参数均需参与签名计算。</p><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="22">1. 公共必选参数</h1><p data-track="23">表格</p><table><tbody><tr class="firstRow"><td data-colwidth="88"><p data-track="25">参数名</p></td><td><p data-track="26">类型</p></td><td><p data-track="27">必填</p></td><td><p data-track="28">描述</p></td></tr><tr><td data-colwidth="88"><p data-track="29">app_key</p></td><td><p data-track="30">String</p></td><td><p data-track="31">是</p></td><td><p data-track="32">应用AppKey，在淘宝开放平台创建应用后获取</p></td></tr><tr><td data-colwidth="88"><p data-track="33">method</p></td><td><p data-track="34">String</p></td><td><p data-track="35">是</p></td><td><p data-track="36">API接口名称，固定为</p><p data-track="37"><br/></p><p data-track="38">taobao.item.get</p></td></tr><tr><td data-colwidth="88"><p data-track="39">session</p></td><td><p data-track="40">String</p></td><td><p data-track="41">是</p></td><td><p data-track="42">用户授权SessionKey，代表当前操作者的身份权限</p></td></tr><tr><td data-colwidth="88"><p data-track="43">timestamp</p></td><td><p data-track="44">String</p></td><td><p data-track="45">是</p></td><td><p data-track="46">时间戳，格式为</p><p data-track="47"><br/></p><p data-track="48">yyyy-MM-dd HH:mm:ss，时区为东八区</p></td></tr><tr><td data-colwidth="88"><p data-track="49">v</p></td><td><p data-track="50">String</p></td><td><p data-track="51">是</p></td><td><p data-track="52">API协议版本，通常为</p><p data-track="53"><br/></p><p data-track="54">2.0</p></td></tr><tr><td data-colwidth="88"><p data-track="55">sign_method</p></td><td><p data-track="56">String</p></td><td><p data-track="57">是</p></td><td><p data-track="58">签名算法，推荐</p><p data-track="59"><br/></p><p data-track="60">hmac-sha256</p></td></tr><tr><td data-colwidth="88"><p data-track="61">sign</p></td><td><p data-track="62">String</p></td><td><p data-track="63">是</p></td><td><p data-track="64">签名值，由AppSecret对参数排序拼接后加密生成</p></td></tr><tr><td data-colwidth="88"><p data-track="65">format</p></td><td><p data-track="66">String</p></td><td><p data-track="67">否</p></td><td><p data-track="68">返回格式，默认为</p><p data-track="69"><br/></p><p data-track="70">json</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="71">2. 业务请求参数</h1><p data-track="72">表格</p><table><tbody><tr class="firstRow"><td data-colwidth="88"><p data-track="74">参数名</p></td><td><p data-track="75">类型</p></td><td><p data-track="76">必填</p></td><td><p data-track="77">描述</p></td></tr><tr><td data-colwidth="88"><p data-track="78">num_iid</p></td><td><p data-track="79">Long</p></td><td><p data-track="80"><strong>是</strong></p></td><td><p data-track="81">商品数字ID（Item ID），即淘宝商品详情页URL中的id参数</p></td></tr><tr><td data-colwidth="88"><p data-track="82">fields</p></td><td><p data-track="83">String</p></td><td><p data-track="84"><strong>是</strong></p></td><td><p data-track="85">需要返回的字段集合，如</p><p data-track="86"><br/></p><p data-track="87">num_iid,title,price,sku。按需指定可大幅提升接口响应速度</p></td></tr></tbody></table><h1 spellcheck="false" class="pgc-h-forward-slash" data-track="88">三、标准JSON返回参考示例</h1><p data-track="89">以下是基于淘宝开放平台官方规范整理的标准成功响应结构，完全匹配淘宝原生接口的返回逻辑，核心字段标注了业务含义，可直接用于开发调试参考：</p><pre language="javascript" code_block="true">{ &nbsp;&nbsp;&quot;taobao_item_get_response&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&quot;code&quot;:&nbsp;0, &nbsp;&nbsp;&nbsp;&nbsp;&quot;msg&quot;:&nbsp;&quot;success&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;request_id&quot;:&nbsp;&quot;tb_req_20260916172245987&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&quot;item&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;num_iid&quot;:&nbsp;1003783113480, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;title&quot;:&nbsp;&quot;Apple&nbsp;iPhone&nbsp;16&nbsp;Pro&nbsp;256GB&nbsp;钛金属&nbsp;移动联通电信5G&nbsp;双卡双待手机&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;nick&quot;:&nbsp;&quot;Apple产品天猫官方旗舰店&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;cid&quot;:&nbsp;50012079, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;outer_id&quot;:&nbsp;&quot;APPLE-IP16PRO-256-TI&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;approve_status&quot;:&nbsp;&quot;onsale&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;num&quot;:&nbsp;12600, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;price&quot;:&nbsp;&quot;8999.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;list_time&quot;:&nbsp;&quot;2026-09-10&nbsp;10:00:00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;delist_time&quot;:&nbsp;&quot;&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;desc&quot;:&nbsp;&quot;&lt;p&gt;全新钛金属设计，A18&nbsp;Pro芯片，超强性能体验...&lt;/p&gt;&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;pic_url&quot;:&nbsp;&quot;https://gd-hbimg.alicdn.com/imgextra/i1/O1CN01kLqZ7L1zqKzqKzqKz_!!6000000007239-2-tps-800-800.jpg&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;num_iid_str&quot;:&nbsp;&quot;1003783113480&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_id&quot;:&nbsp;4567890123456, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;properties&quot;:&nbsp;&quot;1627207:28349;1627209:28351&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;properties_name&quot;:&nbsp;&quot;颜色:原色钛金属;内存:256GB&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;price&quot;:&nbsp;&quot;8999.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;outer_id&quot;:&nbsp;&quot;SKU-001&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;quantity&quot;:&nbsp;3200 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;sku_id&quot;:&nbsp;4567890123457, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;properties&quot;:&nbsp;&quot;1627207:28350;1627209:28351&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;properties_name&quot;:&nbsp;&quot;颜色:白色钛金属;内存:256GB&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;price&quot;:&nbsp;&quot;8999.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;outer_id&quot;:&nbsp;&quot;SKU-002&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;quantity&quot;:&nbsp;2800 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;cid_path&quot;:&nbsp;&quot;50012079,50012080,50012081&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;is_tmall&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;post_fee&quot;:&nbsp;&quot;0.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;express_fee&quot;:&nbsp;&quot;0.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;ems_fee&quot;:&nbsp;&quot;0.00&quot;, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;has_discount&quot;:&nbsp;true, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;video&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;url&quot;:&nbsp;&quot;https://cloud.video.taobao.com/play/u/123456/p/1/e/6/t/1/987654321.mp4&quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;], &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;item_imgs&quot;:&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;item_img&quot;:&nbsp;[ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;url&quot;:&nbsp;&quot;https://img.alicdn.com/imgextra/i1/1.jpg&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;url&quot;:&nbsp;&quot;https://img.alicdn.com/imgextra/i2/2.jpg&quot;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&quot;url&quot;:&nbsp;&quot;https://img.alicdn.com/imgextra/i3/3.jpg&quot;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} }</pre><p data-track="91"><br/></p><p><br/></p>Mon, 21 Sep 2026 15:51:18 +0800