亲测可用的1688商品详情API和关键字搜索API，需要自取！

川长思鸟来 2024-03-08 04:27 88阅读 0赞

###  ###

### 引言 ###

1688是中国最大的B2B电商平台之一，拥有众多的供应商和商品。为了方便用户查找需要的商品，1688提供了关键词搜索商品的API接口。通过该接口开发者可以在自己的系统中调用平台上的数据和功能，例如获取商品信息、下单等操作1。

1688平台提供了丰富的API接口，其中搜索词推荐接口是非常重要的一部分。搜索词推荐接口可以帮助开发者更好地了解商品的情况，拿到商品详情数据。该接口可以帮助开发者提高数据采集的效率，对于需要大量获取1688商品相关信息的电商平台和企业来说，具有较高的实用价值2

### API接口 ###

#### item\_get-获得1688商品详情 ####

#### item\_search-按关键字搜索商品 [获取API免费测试key][API_key] ####

#### 公共参数 ####

<table> 
 <thead> 
 <tr> 
 <th>名称</th> 
 <th>类型</th> 
 <th>必须</th> 
 <th>描述</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td>key</td> 
 <td>String</td> 
 <td>是</td> 
 <td>调用key（必须以GET方式拼接在URL中）</td> 
 </tr> 
 <tr> 
 <td>secret</td> 
 <td>String</td> 
 <td>是</td> 
 <td>调用密钥</td> 
 </tr> 
 <tr> 
 <td>api_name</td> 
 <td>String</td> 
 <td>是</td> 
 <td>API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
 </tr> 
 <tr> 
 <td>cache</td> 
 <td>String</td> 
 <td>否</td> 
 <td>[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
 </tr> 
 <tr> 
 <td>result_type</td> 
 <td>String</td> 
 <td>否</td> 
 <td>[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
 </tr> 
 <tr> 
 <td>lang</td> 
 <td>String</td> 
 <td>否</td> 
 <td>[cn,en,ru]翻译语言，默认cn简体中文</td> 
 </tr> 
 <tr> 
 <td>version</td> 
 <td>String</td> 
 <td>否</td> 
 <td>API版本</td> 
 </tr> 
 </tbody> 
</table>

#### item\_search请求参数 ####

请求参数：q=女装&start\_price=0&end\_price=0&page=1&cat=0&discount\_only=&sort=&page\_size=40&seller\_info=no&nick=&seller\_info=&nick=&ppath=&imgid=&filter=

参数说明：q:搜索关键字  
cat:分类ID  
start\_price:开始价格  
end\_price:结束价格  
sort:排序\[bid,\_bid,\_sale,\_credit\]  
(bid:总价,sale:销量,credit信用,加\_前缀为从大到小排序)  
page:页数 page\_size:每页宝贝数量，默认40  
filter:额外的过滤参数，如：filter=filtId:1,2,3,4;activityType:1,2,3,4;city:天津;quantityBegin:1000  
filtId 过滤：48小时发货,7+天包换,赠运费险,免费赊账;  
activityType 优惠类型:包邮，产地货源，伙拼，手机专享价  
city 地区：地区名  
quantityBegin 起订量：数字

#### item\_search响应参数 ####

Version: Date:

<table> 
 <thead> 
 <tr> 
 <th>名称</th> 
 <th>类型</th> 
 <th>必须</th> 
 <th>示例值</th> 
 <th>描述</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> items </td> 
 <td>items[]</td> 
 <td>0</td> 
 <td></td> 
 <td>按关键字搜索商品</td> 
 </tr> 
 <tr> 
 <td> page </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>1</td> 
 <td>页码</td> 
 </tr> 
 <tr> 
 <td> real_total_results </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>1900</td> 
 <td>宝贝数量</td> 
 </tr> 
 <tr> 
 <td> total_results </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>1900</td> 
 <td>宝贝数量</td> 
 </tr> 
 <tr> 
 <td> page_size </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>20</td> 
 <td>接口返回数量</td> 
 </tr> 
 <tr> 
 <td> pagecount </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>120</td> 
 <td>总页数</td> 
 </tr> 
 <tr> 
 <td> data_from </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> item </td> 
 <td>item[]</td> 
 <td>0</td> 
 <td></td> 
 <td>宝贝详情数据</td> 
 </tr> 
 </tbody> 
</table>

#### item\_get请求参数 ####

请求参数：num\_iid=610947572360

参数说明：num\_iid:1688商品ID  
sales\_data:&sales\_data=1 获取近30天成交数据  
agent:&agent=1 获取1688分销代发价格数据

#### item\_get响应参数 ####

Version: Date:

<table> 
 <thead> 
 <tr> 
 <th>名称</th> 
 <th>类型</th> 
 <th>必须</th> 
 <th>示例值</th> 
 <th>描述</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> item </td> 
 <td>item[]</td> 
 <td>0</td> 
 <td></td> 
 <td>宝贝详情数据</td> 
 </tr> 
 <tr> 
 <td> num_iid </td> 
 <td>String</td> 
 <td>0</td> 
 <td>610947572360</td> 
 <td>宝贝ID</td> 
 </tr> 
 <tr> 
 <td> title </td> 
 <td>String</td> 
 <td>0</td> 
 <td>厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G</td> 
 <td>商品标题</td> 
 </tr> 
 <tr> 
 <td> desc_short </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>商品简介</td> 
 </tr> 
 <tr> 
 <td> price </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>799.00</td> 
 <td>价格</td> 
 </tr> 
 <tr> 
 <td> total_price </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>0</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> suggestive_price </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>0</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> orginal_price </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>799.00</td> 
 <td>原价</td> 
 </tr> 
 <tr> 
 <td> nick </td> 
 <td>String</td> 
 <td>0</td> 
 <td>qin多亲科技</td> 
 <td>卖家昵称</td> 
 </tr> 
 <tr> 
 <td> num </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>2191</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> detail_url </td> 
 <td>String</td> 
 <td>0</td> 
 <td>https://detail.1688.com/offer/610947572360.html</td> 
 <td>宝贝链接</td> 
 </tr> 
 <tr> 
 <td> pic_url </td> 
 <td>String</td> 
 <td>0</td> 
 <td>https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg</td> 
 <td>宝贝图片</td> 
 </tr> 
 <tr> 
 <td> brand </td> 
 <td>String</td> 
 <td>0</td> 
 <td>MAJE</td> 
 <td>品牌</td> 
 </tr> 
 <tr> 
 <td> brandId </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>8879363</td> 
 <td>品牌id</td> 
 </tr> 
 <tr> 
 <td> rootCatId </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>0</td> 
 <td>顶级分类ID</td> 
 </tr> 
 <tr> 
 <td> cid </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>124264005</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> desc </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> item_imgs </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>item_imgs[]</td> 
 <td>商品图片</td> 
 </tr> 
 <tr> 
 <td> item_weight </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> post_fee </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>9.00</td> 
 <td>邮费</td> 
 </tr> 
 <tr> 
 <td> express_fee </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>9.00</td> 
 <td>EMS费用</td> 
 </tr> 
 <tr> 
 <td> ems_fee </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>9.00</td> 
 <td>物流费用</td> 
 </tr> 
 <tr> 
 <td> shipping_to </td> 
 <td>String</td> 
 <td>0</td> 
 <td>广东广州白云区</td> 
 <td>发货至</td> 
 </tr> 
 <tr> 
 <td> video </td> 
 <td>video[]</td> 
 <td>0</td> 
 <td></td> 
 <td>商品视频</td> 
 </tr> 
 <tr> 
 <td> sample_id </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> props_name </td> 
 <td>String</td> 
 <td>0</td> 
 <td>0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色</td> 
 <td>商品属性名</td> 
 </tr> 
 <tr> 
 <td> prop_imgs </td> 
 <td>prop_imgs[]</td> 
 <td>0</td> 
 <td></td> 
 <td>商品属性图片列表</td> 
 </tr> 
 <tr> 
 <td> property_alias </td> 
 <td>String</td> 
 <td>0</td> 
 <td>0:0:64GB;1:0:铁灰色;1:1:瓷白色</td> 
 <td>属性别名</td> 
 </tr> 
 <tr> 
 <td> props </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[{"name": "品牌", "value": "other"}]</td> 
 <td>商品详情</td> 
 </tr> 
 <tr> 
 <td> total_sold </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>1</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> scale </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> sellUnit </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> skus </td> 
 <td>skus[]</td> 
 <td>0</td> 
 <td></td> 
 <td>商品规格信息列表</td> 
 </tr> 
 <tr> 
 <td> seller_id </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>2206619673102</td> 
 <td>卖家ID</td> 
 </tr> 
 <tr> 
 <td> sales </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>100</td> 
 <td>销售额</td> 
 </tr> 
 <tr> 
 <td> shop_id </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>151372205</td> 
 <td>店铺ID</td> 
 </tr> 
 <tr> 
 <td> props_list </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>{"0:0": "机身内存:64GB"}</td> 
 <td>商品属性</td> 
 </tr> 
 <tr> 
 <td> seller_info </td> 
 <td>seller_info[]</td> 
 <td>0</td> 
 <td></td> 
 <td>卖家信息</td> 
 </tr> 
 <tr> 
 <td> tmall </td> 
 <td>Boolean</td> 
 <td>0</td> 
 <td>false</td> 
 <td>是否天猫</td> 
 </tr> 
 <tr> 
 <td> data_from </td> 
 <td>String</td> 
 <td>0</td> 
 <td>1688app</td> 
 <td>错误信息</td> 
 </tr> 
 <tr> 
 <td> error </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>错误信息</td> 
 </tr> 
 <tr> 
 <td> unit </td> 
 <td>String</td> 
 <td>0</td> 
 <td>部;</td> 
 <td>单位</td> 
 </tr> 
 <tr> 
 <td> is_support_mix </td> 
 <td>Boolean</td> 
 <td>0</td> 
 <td>true</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> mix_amount </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>30</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> mix_Begin </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> mix_number </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> sales_data </td> 
 <td>Date</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> location </td> 
 <td>String</td> 
 <td>0</td> 
 <td>广东省 深圳市</td> 
 <td>发货地</td> 
 </tr> 
 <tr> 
 <td> props_img </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td></td> 
 <td>属性图片</td> 
 </tr> 
 <tr> 
 <td> sales_info </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> desc_img </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[{"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg"}]</td> 
 <td>详情图片列表</td> 
 </tr> 
 <tr> 
 <td> shop_item </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> relate_items </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td></td> 
 </tr> 
 </tbody> 
</table>

[API_key]: https://o0b.cn/jennif