在小红书平台上,通过API接口获取商品详情是一个常见的操作。以下是对小红书商品详情API返回值的说明,并附上相应的代码示例。
小红书商品详情API返回值说明
当你通过小红书的商品详情API接口获取商品信息时,服务器会返回一个包含商品详细信息的响应。这个响应通常包含以下字段:
- 商品ID(num_iid) :商品的唯一标识符。
- 商品标题(title) :商品的名称或描述。
- 价格(price) :商品的价格。
- 原价(orginal_price) :商品的原价,通常用于显示折扣信息。
- 卖家昵称(nick) :销售该商品的商家的昵称。
- 库存(num) :商品的库存数量。
- 销量(sales) :商品的销售数量。
- 商品链接(detail_url) :商品的详情页链接。
- 商品描述(desc) :对商品的详细描述,可能包括材质、尺寸、颜色等信息。
- 商品图片(pic_url) :商品的图片链接。
- 商品属性(props_name、props等) :商品的属性信息,如颜色、尺码等。
- 商品规格(skus) :商品的规格信息,包括不同规格的价格、数量等。
此外,响应还可能包含其他字段,如卖家信息(seller_info)、相关商品(relate_items)等,具体字段取决于API接口的版本和请求参数。
代码示例
以下是一个使用Python语言调用小红书商品详情API并处理返回值的示例代码:
python复制代码
import requests | |
# API接口地址和请求参数 | |
api_url = "https://api-服务器.cn/smallredbook/item_get/" | |
params = { | |
'key': '你的API密钥', | |
'secret': '你的API密钥秘密', | |
'num_iid': '商品的ID' # 替换为你想获取详情的商品ID | |
} | |
# 发送GET请求 | |
response = requests.get(api_url, params=params) | |
# 检查响应状态码 | |
if response.status_code == 200: | |
# 解析JSON响应数据 | |
data = response.json() | |
# 打印商品信息 | |
print("商品ID:", data['num_iid']) | |
print("商品标题:", data['title']) | |
print("价格:", data['price']) | |
print("原价:", data['orginal_price']) | |
print("卖家昵称:", data['nick']) | |
print("库存:", data['num']) | |
print("销量:", data['sales']) | |
print("商品链接:", data['detail_url']) | |
print("商品图片:", data['pic_url']) | |
# 根据需要打印其他字段信息 | |
else: | |
print("请求失败,状态码:", response.status_code) |
注意事项
- API密钥:在调用API之前,你需要在小红书开放平台注册账号并完成实名认证,以获取API访问权限和密钥。
- 请求参数:确保你传递的请求参数正确无误,特别是商品ID(num_iid),它是获取商品详情的必要参数。
- 异常处理:在实际应用中,你需要添加异常处理逻辑来捕获和处理可能出现的错误,如网络错误、API限制等。
- 数据解析:返回的响应数据通常是JSON格式,你可以使用Python内置的
json模块来解析和处理这些数据。api获取key测试
通过以上步骤和代码示例,你可以成功调用小红书的商品详情API接口并获取商品的详细信息。