一、引言
在当今数字化的商业世界中，电商平台数据的价值日益凸显。小红书作为一个集社交与电商于一体的平台，拥有大量的商品信息。这些商品信息涵盖了美妆、时尚、生活家居等众多品类，反映了当下消费者的兴趣和市场趋势。对于商家而言，通过分析小红书上的商品数据，可以了解竞争对手的情况，制定更精准的营销策略；对于开发者和数据分析师来说，获取这些数据有助于进行市场调研、构建推荐系统等工作。然而，直接从小红书网页或 APP 端抓取商品数据面临诸多困难，如反爬机制、数据格式复杂等。因此，使用小红书商品列表 API 接口成为了一种高效、合法且稳定的数据获取方式。
二、接口概述
（一）接口功能
该接口主要用于获取小红书平台上的商品列表信息。通过调用此接口，用户可以根据不同的筛选条件（如关键词、品类、热度等）获取符合要求的商品列表，列表中包含商品的基本信息，如商品名称、商品图片链接、商品价格、商品销量、商品所属店铺等。
（二）接口请求方式
通常采用 HTTP 请求方式，常见的是 GET 请求。在请求时，需要向接口传递必要的参数，例如：
关键词（keyword） ：用于搜索特定名称或相关主题的商品。
品类（category） ：指定商品所属的品类，如美妆、数码等。
页码（page） ：用于分页获取商品列表，方便获取多页数据。
（三）接口返回数据格式
接口返回的数据一般为 JSON 格式，这是一种轻量级的数据交换格式，易于解析和处理。JSON 数据以键值对的形式组织，商品列表通常以数组的形式呈现，每个商品对象包含多个属性。
三、Python 请求示例
（一）环境准备
在开始之前，需要确保已经安装了 Python 环境，并且安装了requests库，用于发送 HTTP 请求。
（二）代码示例
python
import requests
# 封装好的第三方数据商小红书平台接口，复制链接获取测试。
demo url=c0b.cc/R4rbK2 wechat id:Taobaoapi2014
# 假设的接口地址，实际使用时需替换为真实有效的地址
api_url = "https://example-xiaohongshu-api.com/products"
# 假设的 API Key，实际使用时需替换为真实获取的 API Key
api_key = "your_api_key"
# 构造请求头，包含 API Key 用于身份验证
headers = {
"Authorization": f"Bearer {api_key}"
}
# 构造请求参数
params = {
"keyword": "口红", # 搜索关键词
"category": "美妆", # 商品品类
"page": 1 # 页码
}
try:
# 发送 GET 请求
response = requests.get(api_url, headers=headers, params=params)
# 检查响应状态码
if response.status_code == 200:
# 解析 JSON 数据
data = response.json()
# 获取商品列表
products = data.get("products", [])
if products:
for product in products:
print(f"商品 ID: {product.get('product_id')}")
print(f"商品名称: {product.get('product_name')}")
print(f"商品图片链接: {product.get('image_url')}")
print(f"商品价格: {product.get('price')}")
print(f"商品销量: {product.get('sales_volume')}")
print(f"商品所属店铺: {product.get('store_name')}")
print("-" * 50)
else:
print("未找到符合条件的商品。")
else:
print(f"请求失败，状态码: {response.status_code}")
except requests.RequestException as e:
print(f"请求发生错误: {e}")
except ValueError as e:
print(f"解析 JSON 数据时出错: {e}")
（三）代码解释
导入库：导入requests库，用于发送 HTTP 请求。
设置接口地址和 API Key：定义接口的 URL 和用于身份验证的 API Key。
构造请求头和参数：创建包含 API Key 的请求头，同时构造包含搜索关键词、商品品类和页码的请求参数。
发送请求：使用requests.get()方法发送 GET 请求，将请求头和参数传递给该方法，并将响应存储在response对象中。
处理响应：检查响应的状态码，如果状态码为 200，表示请求成功，解析 JSON 数据并获取商品列表；如果商品列表不为空，则遍历打印每个商品的信息；否则，提示未找到符合条件的商品。如果状态码不为 200，则打印请求失败的信息。
异常处理：使用try-except语句捕获请求过程中可能出现的异常，如网络错误和 JSON 解析错误，并打印相应的错误信息。
需要注意的是，上述代码中的接口地址、API Key 等信息需要根据实际情况进行替换。同时，在实际使用中，要根据接口的具体文档和要求对代码进行调整。
