Python爬虫学习笔记：1688商品详情API 开发API接口文档

快来打我* 2024-03-17 20:54 26阅读 0赞

![8958464c58234fb95a4d4b7322a94c51.jpeg][]

1688API接口是阿里巴巴集团推出的一种开放平台，提供了丰富的数据接口、转换工具以及开发资源，为开发者提供了通用的应用接口及大量数据资源，支持开发者在1688上进行商品搜索、订单管理、交易报表及物流等方面的操作。

1688API接口主要包含以下几类：

商品API：提供商品搜索、商品详情、商品发布等接口。

订单API：提供订单查询、订单状态更新、订单创建等接口。

物流API：提供物流信息查询、物流订单查询等接口。

用户API：提供用户信息查询、用户认证等接口。

数据API：提供交易报表、商品统计等接口。

开发者可基于1688API接口打造自己的在线商城、批发平台及电商应用等，实现企业信息化、资源共享、创新发展等目标。

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

公共参数

<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><a href="https://o0b.cn/jennif" rel="nofollow" title="调用密钥">调用密钥</a></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>

请求参数

请求参数：num\_iid=610947572360

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

请求示例（Curl PHP PHPsdk JAVA C\# Python Golang javascript JS-SDK Ruby Swift Objective-C C C++ Node.JS Kotlin Rust R MATLAB ）

import java.io.BufferedReader;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.io.Reader;
 import java.net.URL;
 import java.nio.charset.Charset;
 import org.json.JSONException;
 import org.json.JSONObject;
 import java.io.PrintWriter;
 import java.net.URLConnection;
 
 public class Example {
 	private static String readAll(Reader rd) throws IOException {
 		StringBuilder sb = new StringBuilder();
 		int cp;
 		while ((cp = rd.read()) != -1) {
 			sb.append((char) cp);
 		}
 		return sb.toString();
 	}
 	public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
 		URL realUrl = new URL(url);
 		URLConnection conn = realUrl.openConnection();
 		conn.setDoOutput(true);
 		conn.setDoInput(true);
 		PrintWriter out = new PrintWriter(conn.getOutputStream());
 		out.print(body);
 		out.flush();
 		InputStream instream = conn.getInputStream();
 		try {
 			BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
 			String jsonText = readAll(rd);
 			JSONObject json = new JSONObject(jsonText);
 			return json;
 		} finally {
 			instream.close();
 		}
 	}
 	public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
 		URL realUrl = new URL(url);
 		URLConnection conn = realUrl.openConnection();
 		InputStream instream = conn.getInputStream();
 		try {
 			BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
 			String jsonText = readAll(rd);
 			JSONObject json = new JSONObject(jsonText);
 			return json;
 		} finally {
 			instream.close();
 		}
 	}
 	public static void main(String[] args) throws IOException, JSONException {
 		// 请求示例 url 默认请求参数已经URL编码处理
 		String url = "https://api-gw.onebound.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360";
 		JSONObject json = getRequestFromUrl(url);
 		System.out.println(json.toString());
 	}
 
 }

响应参数

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>

[8958464c58234fb95a4d4b7322a94c51.jpeg]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/8ce7995e1375467890ba34a56178e2a4.png