小红书获得商品详情 API 返回值示例

Brad_19970108118
65 阅读2分钟

小红书商品详情 API 可帮助开发者获取平台上特定商品的详细信息。以下是关于该 API 介绍：

小红书作为国内知名电商平台，为开发者提供了丰富的API接口，小红书商品详情API 接口可帮助开发者获取小红书的商品数据。 该接口可用于电商数据分析、商品展示平台搭建、价格监控系统开发等多种场景‌。通过API获取商品数据比传统爬虫方式更稳定高效，且符合平台规范‌。

  • 请求方式：通常支持 HTTP GET 或 POST 请求方式，GET 请求适用于简单的数据查询，POST 请求更适合携带复杂参数或有安全要求的数据请求。

公共参数

请求注册地址

名称类型必须描述
keyString是调用key（必须以GET方式拼接在URL中）
secretString是调用密钥
api_nameString是API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cacheString否[yes,no]默认yes，将调用缓存的数据，速度比较快
result_typeString否[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
langString否[cn,en,ru]翻译语言，默认cn简体中文
versionString否API版本

小红书商品详情 API 的返回值通常为 JSON 格式，以下是一个返回值示例：

  "code": 200,
  "message": "success",
  "data": {
    "item_id": "xhs_1234567890", // 商品唯一ID
    "title": "2023新款复古墨镜女明星同款时尚太阳镜",
    # 假设 API 接口地址，复制链接获取测试 API url=o0b.cn/ibrad
    "subtitle": "防紫外线UV400 显脸小设计",
    "cover_image": "https://img.xiaohongshu.com/item/cover/abc123.jpg",
    "image_list": [
      "https://img.xiaohongshu.com/item/1.jpg",
      "https://img.xiaohongshu.com/item/2.jpg",
      "https://img.xiaohongshu.com/item/3.jpg"
    ],
    "price": 159.00, // 当前售价（单位：元）
    "original_price": 299.00, // 划线原价
    "discount": "5.3折", // 折扣信息
    "sales": 12480, // 销量
    "stock": 342, // 库存
    "brand": "GENTLE MONSTER", // 品牌
    "category": ["配饰", "眼镜", "太阳镜"], // 商品分类
    "tags": ["明星同款", "显脸小", "防紫外线"], // 标签
    "specs": [ // 规格选项
      {
        "name": "颜色",
        "values": ["黑色", "茶色", "玳瑁色"]
      },
      {
        "name": "镜片材质",
        "values": ["偏光镜", "非偏光"]
      }
    ],
    "detail_html": "<div>...商品详情HTML内容...</div>", // 富文本详情
    "logistics_info": { // 物流信息
      "delivery_region": "上海", // 发货地
      "delivery_time": "48小时内", // 发货时效
      "freight": "免运费" // 运费
    },
    "shop_info": { // 店铺信息
      "shop_id": "shop_98765",
      "shop_name": "官方旗舰店",
      "shop_rating": 4.9 // 店铺评分
    },
    "promotions": [ // 促销活动
      {
        "type": "coupon",
        "title": "新人券",
        "value": "满150减20"
      }
    ],
    "service_guarantee": [ // 服务保障
      "7天无理由退换",
      "正品保证",
      "过敏包退"
    ],
    "created_time": "2023-08-01 10:30:00", // 商品创建时间
    "updated_time": "2023-08-10 15:22:18" // 最后更新时间
  }
}

实际接口设计需根据业务需求调整字段，建议加入 user_ratings（用户评价）、related_items（关联商品）等扩展字段增强丰富度。

avatar
文章
阅读
粉丝