深入解析 Python 爬取 1688 APP 商品详情数据：item_get_app 接口返回数据实战指南

在电商数据分析和市场调研中，获取商品的详细信息至关重要。1688 作为国内知名的 B2B 电商平台，提供了丰富的商品数据接口，其中 item_get_app 接口可用于获取商品的详细信息。本文将详细介绍如何使用 Python 调用 item_get_app 接口，获取 1688 APP 上的商品原数据，并对返回数据进行详细说明。

一、接口调用前的准备

（一）注册账号并创建应用

在调用 1688 的 API 接口之前，需要在 1688 开放平台注册开发者账号，并创建应用以获取 App Key 和 App Secret。这些凭证是调用接口的必要条件。

（二）安装 Python 环境和所需库

确保你的开发环境中已安装 Python，并安装以下库：

requests：用于发送 HTTP 请求。
hashlib：用于生成签名。
time：用于生成时间戳。

可以使用以下命令安装 requests 库：

bash

复制

pip install requests

二、接口调用流程

（一）构建请求参数

调用 item_get_app 接口时，需要构建以下参数：

公共参数：
- app_key：应用的 App Key。
- timestamp：请求的时间戳，格式为 YYYY-MM-DD HH:MM:SS。
- sign_method：签名方法，目前仅支持 md5。
- v：API 版本，固定为 2.0。
- format：返回数据格式，固定为 json。
- sign：签名结果，用于验证请求的合法性。
业务参数：
- num_iid：商品的唯一标识符（商品 ID）。
- fields：需要返回的商品详情字段，如 title,price,pic_url,desc 等。

（二）生成签名

签名是接口调用中的重要环节，用于确保请求的安全性。以下是生成签名的 Python 示例代码：

Python

import hashlib
import time

def generate_sign(params, app_secret):
    """生成签名"""
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    param_str = app_secret + ''.join(f"{k}{v}" for k, v in sorted_params) + app_secret
    sign = hashlib.md5(param_str.encode('utf-8')).hexdigest().upper()
    return sign

（三）发送请求并解析响应

以下是一个完整的 Python 示例代码，展示如何调用 item_get_app 接口并解析返回的 JSON 数据：

Python

import requests

def call_item_get_app(app_key, app_secret, num_iid):
    """调用 1688.item_get_app 接口"""
    url = "https://api.1688.com/router/rest"
    timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
    params = {
        "app_key": app_key,
        "timestamp": timestamp,
        "sign_method": "md5",
        "v": "2.0",
        "format": "json",
        "api_name": "item_get_app",
        "num_iid": num_iid,
        "fields": "title,pic_url,price,sales,detail_url,shop_name,shop_url,sku"
    }
    params["sign"] = generate_sign(params, app_secret)
    response = requests.get(url, params=params)
    if response.status_code == 200:
        return response.json()
    else:
        print(f"Request failed with status code: {response.status_code}")
        return None

# 示例调用
app_key = "your_app_key"
app_secret = "your_app_secret"
num_iid = "商品ID"
data = call_item_get_app(app_key, app_secret, num_iid)
print(data)

三、返回数据说明

调用 item_get_app 接口后，返回的数据通常为 JSON 格式，包含以下字段：

（一）商品基本信息

num_iid：商品的唯一标识符。
title：商品标题。
desc：商品描述。
price：商品价格。
pic_url：商品主图的 URL。
sales：商品销量。
detail_url：商品详情页 URL。
shop_name：店铺名称。
shop_url：店铺首页 URL。

（二）SKU 信息

sku：商品的 SKU 信息，包括 SKU ID、名称和价格。SKU 是商品的可销售属性组合，如不同颜色、尺寸等。

（三）其他字段

code：返回状态码，200 表示成功。
message：返回状态信息，success 表示请求成功。

四、数据处理与应用

获取到商品详情数据后，可以根据需求进行进一步的数据处理和分析。例如，可以使用 pandas 库将数据保存为 CSV 文件，方便后续使用：

Python

import pandas as pd

# 示例：提取商品标题和价格
products = data.get('item', [])
df = pd.DataFrame(products)
df.to_csv('item_details.csv', index=False, encoding='utf-8')