当前位置：首页 > article >正文

利用Java爬虫获取1688商品详情：API返回值说明及代码示例

article 2025/1/9 22:35:43

在当今的电商时代，商品信息的获取对于商家、消费者以及市场分析师来说至关重要。1688作为国内领先的B2B电商平台，拥有海量的商品资源。通过Java爬虫技术，我们可以高效地获取1688商品的详细信息，为数据分析、市场调研、产品选品等提供有力支持。本文将详细介绍如何利用Java爬虫获取1688商品详情，并对API返回值进行说明，最后给出代码示例。

1688商品详情API简介

1688商品详情API（接口名称为1688.item_get）是1688开放平台提供的一个关键接口，用于获取指定商品的详细信息。该接口支持HTTP请求方式，包括GET和POST方法，返回格式为JSON。通过调用该接口，我们可以获取商品的标题、价格、描述、图片等关键信息，为后续的业务处理提供数据基础。

API返回值说明

成功调用1688商品详情API后，将收到一个包含商品详情的JSON响应。以下是一些常见的返回字段及其说明：

num_iid：商品ID，用于唯一标识一个商品。它是获取商品详情的关键参数，通过这个ID可以查询到商品的所有相关信息。
title：商品名称，描述商品的主要特征。它通常包含了商品的核心卖点和关键词，对于搜索引擎优化和用户搜索具有重要意义。
desc_short：商品简短描述，通常用于商品列表展示。它为用户提供了一个快速了解商品的途径，简洁明了地概括了商品的主要特点。
price：商品价格，表示商品的销售价格。它是用户最为关心的信息之一，对于商家来说，价格的设置也直接影响着商品的销售和利润。
total_price：商品总价，如果商品有多个SKU，表示所有SKU的总价。对于一些组合销售或者有多种规格的商品，总价信息尤为重要。
suggestive_price：建议价格，商家推荐的售价。它通常用于促销活动或者作为参考价格，帮助用户更好地了解商品的价值。
original_price：原价，商品的原始价格，通常用于促销活动。通过与促销价格的对比，用户可以直观地看到优惠的力度。
nick：卖家昵称，表示商品的卖家。了解卖家的信息有助于用户判断商品的可信度和卖家的服务质量。
num：商品库存数量，表示商品的可售数量。库存信息对于商家的库存管理和用户的购买决策都具有指导意义。
detail_url：商品详情页的URL，用于访问商品的详细信息页面。通过这个链接，用户可以进一步了解商品的详细信息和用户评价等。
pic_url：商品图片的URL，通常为主图的链接。商品图片是用户了解商品外观和特点的重要途径，高质量的图片可以提升用户的购买欲望。
brand：品牌名称，表示商品所属的品牌。品牌信息有助于用户了解商品的品质和市场定位。
brandid：品牌ID，用于标识商品的品牌。品牌ID可以用于进一步查询品牌的详细信息或者进行品牌相关的数据分析。
rootcatid：根类目ID，表示商品所属的顶级类目。类目信息有助于对商品进行分类和管理，也方便用户根据类目进行筛选和搜索。
cid：类目ID，表示商品所属的具体类目。具体类目信息可以更准确地描述商品的分类属性，为用户和商家提供更细致的分类依据。
desc：商品详细描述，包含商品的详细信息和卖点。详细描述为用户提供了一个全面了解商品的途径，包括商品的材质、功能、使用方法等。
item_imgs：商品图片列表，包含商品的所有图片链接。通过多个图片的展示，用户可以从不同角度和细节了解商品，提高购买的信心。
item_weight：商品重量，表示商品的重量信息。重量信息对于物流配送和运费计算具有重要意义。
post_fee：邮费，表示商品的普通邮寄费用。邮费信息是用户在购买商品时需要考虑的一个重要因素。
express_fee：快递费，表示商品的快递费用。快递费用通常比普通邮寄费用要高，但可以提供更快的配送服务。
ems_fee：EMS费，表示商品的EMS邮寄费用。EMS是一种特殊的快递服务，具有较高的时效性和安全性。
shipping_to：发货地，表示商品的发货地点。了解发货地有助于用户预估商品的到货时间和运费。
video：商品视频，包含商品的视频链接。视频是展示商品动态效果和使用场景的有效方式，可以更好地吸引用户的注意力。
sample_id：样品ID，用于标识商品的样品。样品信息对于一些需要提供样品的商家来说非常重要。
props_name：商品属性名称，表示商品的属性名称。属性名称用于描述商品的规格和特点，如颜色、尺寸、材质等。
prop_imgs：属性图片，包含商品属性的图片链接。属性图片可以直观地展示商品的属性特点，提高用户的理解度。
property_alias：属性别名，表示商品属性的别名。别名可以用于不同的市场和语言环境，方便用户理解和记忆。
props：商品属性列表，包含商品的所有属性信息。属性列表为用户提供了全面的商品规格和特点信息，有助于用户进行选择和比较。

Java爬虫代码示例

以下是一个使用Java的HttpURLConnection类来请求1688商品详情API的示例代码：

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.HashMap;
import java.util.Map;
import java.util.TreeMap;
import org.json.JSONObject;

public class AlibabaItemDetailSpider {
    private static final String APP_KEY = "your_app_key";
    private static final String APP_SECRET = "your_app_secret";
    private static final String ITEM_ID = "123456789"; // 商品ID，替换为实际要查询的商品ID

    public static void main(String[] args) {
        try {
            // 构造请求参数
            Map<String, String> params = new HashMap<>();
            params.put("item_id", ITEM_ID);
            params.put("format", "json"); // 请求返回JSON格式数据，可按需更改
            params.put("timestamp", String.valueOf(System.currentTimeMillis())); // 当前时间戳（毫秒）
            params.put("app_key", APP_KEY);

            // 对参数进行排序并拼接成字符串，然后和App Secret拼接后进行MD5加密生成签名
            Map<String, String> sortedParams = new TreeMap<>(params);
            StringBuilder paramStrBuilder = new StringBuilder();
            for (Map.Entry<String, String> entry : sortedParams.entrySet()) {
                paramStrBuilder.append(entry.getKey()).append("=").append(entry.getValue()).append("&");
            }
            String paramStr = paramStrBuilder.toString();
            String signStr = paramStr + APP_SECRET;
            String sign = md5(signStr).toUpperCase();
            params.put("sign", sign);

            // 构造请求URL
            StringBuilder urlBuilder = new StringBuilder("https://gw.open.1688.com/openapi/param2/1/system.oauth2/1688.item_get?");
            for (Map.Entry<String, String> entry : params.entrySet()) {
                urlBuilder.append(entry.getKey()).append("=").append(entry.getValue()).append("&");
            }
            String url = urlBuilder.toString();
            url = url.substring(0, url.length() - 1); // 去掉最后一个&符号

            // 发起GET请求
            HttpURLConnection connection = (HttpURLConnection) new URL(url).openConnection();
            connection.setRequestMethod("GET");
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");

            // 读取响应内容
            BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
            StringBuilder responseBuilder = new StringBuilder();
            String line;
            while ((line = reader.readLine()) != null) {
                responseBuilder.append(line);
            }
            reader.close();
            connection.disconnect();

            // 处理返回结果
            JSONObject result = new JSONObject(responseBuilder.toString());
            System.out.println(result.toString(2)); // 打印格式化的JSON结果
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    // MD5加密方法
    private static String md5(String str) {
        try {
            java.security.MessageDigest md = java.security.MessageDigest.getInstance("MD5");
            byte[] array = md.digest(str.getBytes());
            StringBuilder sb = new StringBuilder();
            for (byte b : array) {
                sb.append(Integer.toHexString((b & 0xFF) | 0x100).substring(1, 3));
            }
            return sb.toString();
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }
}

在上述代码中：

注意事项

结语

通过Java爬虫技术，我们可以高效地获取1688商品的详细信息，为电商运营、市场分析等提供有力的数据支持。掌握1688商品详情API的使用方法和返回值说明，能够帮助我们更好地利用这些数据，提升业务决策的科学性和准确性。在实际应用中，还可以结合其他技术和工具，如数据库、数据分析框架等，进一步挖掘数据的价值，为业务发展提供更全面的解决方案。