小红书获得某书商品详情 API 返回值说明

207 阅读3分钟

在小红书平台上,通过API接口获取商品详情是一个常见的操作。以下是对小红书商品详情API返回值的说明,并附上相应的代码示例。

小红书商品详情API返回值说明

当你通过小红书的商品详情API接口获取商品信息时,服务器会返回一个包含商品详细信息的响应。这个响应通常包含以下字段:

  1. 商品ID(num_iid) :商品的唯一标识符。
  2. 商品标题(title) :商品的名称或描述。
  3. 价格(price) :商品的价格。
  4. 原价(orginal_price) :商品的原价,通常用于显示折扣信息。
  5. 卖家昵称(nick) :销售该商品的商家的昵称。
  6. 库存(num) :商品的库存数量。
  7. 销量(sales) :商品的销售数量。
  8. 商品链接(detail_url) :商品的详情页链接。
  9. 商品描述(desc) :对商品的详细描述,可能包括材质、尺寸、颜色等信息。
  10. 商品图片(pic_url) :商品的图片链接。
  11. 商品属性(props_name、props等) :商品的属性信息,如颜色、尺码等。
  12. 商品规格(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)

注意事项

  1. API密钥:在调用API之前,你需要在小红书开放平台注册账号并完成实名认证,以获取API访问权限和密钥。
  2. 请求参数:确保你传递的请求参数正确无误,特别是商品ID(num_iid),它是获取商品详情的必要参数。
  3. 异常处理:在实际应用中,你需要添加异常处理逻辑来捕获和处理可能出现的错误,如网络错误、API限制等。
  4. 数据解析:返回的响应数据通常是JSON格式,你可以使用Python内置的json模块来解析和处理这些数据。api获取key测试

通过以上步骤和代码示例,你可以成功调用小红书的商品详情API接口并获取商品的详细信息。