SocialDataX API

小红书 API 文档

小红书笔记搜索、内容详情、评论、用户资料与发布列表接口，包含请求参数、返回字段和计费说明。

读取小红书搜索热榜

读取小红书搜索热榜，返回热榜标题和热度值。

POST /socialdatax/api/v1/xhs/hot/search/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

请求示例

{}

返回字段

items（必填）：搜索热榜条目列表
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "title": "用万能旅行拍照姿势美美出片",
      "hot_value": 9255000
    }
  ],
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书搜索建议

按搜索词读取候选搜索建议，返回建议文本、搜索目标和补充说明。

POST /socialdatax/api/v1/xhs/search/suggestions

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：搜索词，可传正在输入的关键词或短语；不要传笔记链接、主页链接、note_id、user_id 或分页令牌。

请求示例

{
  "keyword": "露营"
}

返回字段

items（必填）：搜索建议条目列表
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "text": "露营装备",
      "search_target": "notes",
      "description": null
    }
  ],
  "points": {
    "cost": 10,
    "balance": 990
  }
}

搜索小红书笔记

按关键词和筛选条件搜索公开小红书笔记；默认搜索所有类型，设置 note_type="image" 搜索图文笔记，设置 note_type="video" 搜索视频笔记。返回结构化笔记摘要和下一页分页令牌。结果包含可识别的广告笔记，is_ad 表示是否为广告；is_cooperation_note 表示是否带有商业合作笔记标记。

POST /socialdatax/api/v1/xhs/note/search

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：搜索词，可传关键词或短语，例如品牌名、话题、人物名、产品名或内容需求；不要传笔记链接、主页链接、note_id、user_id 或 page_token。
sort_type：笔记搜索结果排序方式。
note_type：笔记类型筛选。
publish_time_range：发布时间范围筛选。
page_token：笔记搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只能用于同一笔记搜索链路，不能跨关键词、排序、笔记类型、发布时间范围和调用方复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。

请求示例

{
  "keyword": "露营",
  "sort_type": "general",
  "note_type": "all",
  "publish_time_range": "all",
  "page_token": ""
}

返回字段

items（必填）：笔记搜索结果中的笔记列表，包含可识别的广告笔记，已过滤非笔记卡片与不可公开笔记；当前页过滤后可能为空数组
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多结果或无法继续 token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 仅限同一工具、关键词和调用方；保持该工具支持的筛选条件不变，不得跨搜索工具复用；items 为空时不要单独据此判断结束。不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "note_url": "https://www.xiaohongshu.com/discovery/item/69e71b110000000022029e5e?xsec_source=app_share&xsec_token=CB8LYwuNCmdLCh4IingDx12rfddpSYoSu-dkiRRHnsk6o=",
      "note_id": "69e71b110000000022029e5e",
      "note_type": "image",
      "title": "露营装备清单",
      "is_ad": false,
      "is_cooperation_note": false,
      "summary": "适合周末出行的装备组合。",
      "cover_image_url": "https://example.invalid/cover.webp",
      "like_count": 120,
      "collect_count": 35,
      "comment_count": 18,
      "share_count": 4,
      "publish_time": 1714316800,
      "update_time": null,
      "video": null,
      "author": {
        "user_id": "67c25fdc000000000a03dae1",
        "name": "露营研究员",
        "avatar_url": "https://example.invalid/avatar.webp",
        "profile_url": "https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1",
        "red_id": "camp-001"
      }
    }
  ],
  "next_page_token": "opaque-search-page-token",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

搜索小红书图片

按关键词从小红书图片搜索标签获取图片，每项返回图片标识、地址、尺寸及关联笔记信息；同一笔记可返回多张图片。下一页令牌仅表示可尝试续页，不保证下一页有结果。结果按平台相关性排序，不承诺每条标题或正文都包含原词，也不承诺完整召回；需要图文笔记而非单张图片时使用 xhs_search_notes(note_type="image")；需要视频笔记时使用 xhs_search_notes(note_type="video")。

POST /socialdatax/api/v1/xhs/image/search

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：搜索词，可传关键词或短语，例如露营、建筑、穿搭；不要传笔记链接、主页链接、note_id、user_id 或 page_token。
page_token：媒体搜索分页令牌，首次请求留空；仅限同一工具、关键词和调用方，不得跨视频、图片或综合笔记搜索复用。将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。

请求示例

{
  "keyword": "露营",
  "page_token": ""
}

返回字段

items（必填）：图片列表；同一笔记的多张图片分别返回
next_page_token（必填）：可尝试下一页的不透明分页令牌，不保证下一页有结果；为空表示无法继续翻页。续页保持关键词和调用方不变，并将完整令牌原样传回图片搜索入口。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "note_url": "https://www.xiaohongshu.com/discovery/item/69e71b110000000022029e5e?xsec_source=app_share&xsec_token=CB8LYwuNCmdLCh4IingDx12rfddpSYoSu-dkiRRHnsk6o=",
      "note_id": "69e71b110000000022029e5e",
      "title": "露营装备清单",
      "summary": "适合周末出行的装备组合。",
      "image_id": "example-image-1",
      "image_url": "https://example.invalid/image.webp",
      "width": 1280,
      "height": 2276,
      "like_count": 120,
      "collect_count": 35,
      "comment_count": 18,
      "share_count": 4,
      "publish_time_text": "2025-08-21",
      "author": {
        "user_id": "67c25fdc000000000a03dae1",
        "name": "露营研究员",
        "avatar_url": "https://example.invalid/avatar.webp",
        "profile_url": "https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1",
        "red_id": "camp-001"
      }
    }
  ],
  "next_page_token": "opaque-image-search-page-token",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

搜索小红书用户

按关键词搜索小红书用户、账号或博主，返回用户摘要和下一页令牌；续页保持关键词不变，结果可能重复或遗漏。已有用户 ID 或主页链接时使用用户资料接口。

POST /socialdatax/api/v1/xhs/user/search

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：搜索词，可传昵称、账号名或小红书号；不要传主页链接、user_id 或分页令牌。
page_token：用户搜索分页令牌，首次请求留空；续页保持 keyword 不变，将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。

请求示例

{
  "keyword": "咖啡",
  "page_token": ""
}

返回字段

items（必填）：搜索到的用户列表
next_page_token（必填）：下一页分页令牌，为空表示结束；续页保持 keyword 不变并完整原样传回。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "user_id": "67c25fdc000000000a03dae1",
      "name": "咖啡日记",
      "avatar_url": "https://example.invalid/avatar.webp",
      "red_id": "coffee_diary",
      "verified": false
    }
  ],
  "next_page_token": "opaque-user-search-page-token",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

搜索小红书商品

按关键词搜索公开小红书商品，返回商品信息和下一页分页令牌。

POST /socialdatax/api/v1/xhs/product/search

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：搜索词，可传商品名、品牌名、品类或商品需求；不要传商品链接、sku_id、spu_id 或 page_token。
page_token：商品搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一商品关键词和调用方的商品搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。

请求示例

{
  "keyword": "露营",
  "page_token": ""
}

返回字段

items（必填）：商品搜索结果列表
next_page_token（必填）：下一页不透明商品搜索分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一商品关键词和调用方的商品搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "sku_id": "691c1de31896c300014f6ea8",
      "spu_id": "691c1de31896c300014f6ea7",
      "title": "露营折叠桌",
      "description": "适合露营使用的折叠桌",
      "image_url": "https://example.invalid/product.webp",
      "price": 299,
      "coupon_price": 296,
      "shop_id": "69d25a8635183b00159be6ef",
      "shop_name": "露营装备店",
      "shop_avatar_url": "https://example.invalid/shop.webp",
      "stock_quantity": 19,
      "purchasable": true,
      "sold_count": 5,
      "sales_text": "已售5"
    }
  ],
  "next_page_token": "opaque-product-page-token",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书商品详情

根据完整 sku_id 或商品链接读取小红书商品详情；sku_id 与 url 必须二选一，url 支持商品详情链接、短链接和包含商品链接的分享文案。返回价格、店铺、图片、发货和规格参数。

POST /socialdatax/api/v1/xhs/product/detail

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

sku_id：小红书商品 SKU ID；用户已提供完整 sku_id 时原样使用，否则可从商品搜索结果复制。与 url 二选一；不要在此字段传 spu_id、商品链接或搜索关键词。
url：小红书商品详情链接、短链接或包含商品链接的分享文案；与 sku_id 二选一。

请求示例

{
  "sku_id": "691c1de31896c300014f6ea8"
}

返回字段

sku_id（必填）：商品 SKU ID
title（必填）：商品标题
price（必填）：当前 SKU 的商品原价，单位：元；不是商品搜索的展示销售价，也不是最终实付价
coupon_price（必填）：当前 SKU 展示的券后/成交价格，单位：元；不保证是最终实付价
sold_count（必填）：已售数量；平台以带“+”的千级或万级文本展示时转换为对应整数下限（如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000），不是精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0。
sales_text（必填）：平台展示的商品销量文本；没有时为空字符串。带“+”的数量表示下限，不是精确销量；结合 sold_count 解读。
stock_status（必填）：库存状态码；具体码值含义未公开定义，不要自行解释为是否在售或是否可购买
shop_id（必填）：店铺 ID
shop_name（必填）：店铺名称
shop_avatar_url（必填）：店铺头像链接
main_images（必填）：商品顶部主图/轮播图列表
detail_images（必填）：商品详情图列表
selected_variant（必填）：当前选中规格；没有规格时为空字符串
assurances（必填）：商品保障服务列表
shipping（必填）：发货信息
shop_score（必填）：店铺评分展示值；没有评分时为空字符串
shop_fans_text（必填）：店铺粉丝数展示值；没有粉丝信息时为空字符串
shop_sold_text（必填）：店铺已售展示值；没有已售信息时为空字符串
specifications（必填）：商品属性/规格参数列表（name/value），不是可选 SKU 规格组
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "sku_id": "691c1de31896c300014f6ea8",
  "title": "露营折叠桌",
  "price": 299,
  "coupon_price": 296,
  "sold_count": 5,
  "sales_text": "已售5",
  "stock_status": 1,
  "shop_id": "69d25a8635183b00159be6ef",
  "shop_name": "露营装备店",
  "shop_avatar_url": "https://example.invalid/shop.webp",
  "main_images": [
    {
      "image_url": "https://example.invalid/product.webp",
      "width": 1200,
      "height": 1200
    }
  ],
  "detail_images": [
    {
      "image_url": "https://example.invalid/detail.webp",
      "width": 1200,
      "height": 800
    }
  ],
  "selected_variant": "默认规格",
  "assurances": [
    "7天无理由退货"
  ],
  "shipping": {
    "location": "浙江宁波",
    "fee": "包邮",
    "text": "预计24小时内发货"
  },
  "shop_score": "4.8",
  "shop_fans_text": "1200",
  "shop_sold_text": "3500",
  "specifications": [
    {
      "name": "商品名称",
      "value": "露营折叠桌"
    }
  ],
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书商品评价

根据完整 sku_id 读取小红书商品评价；用户已提供时直接使用，否则可从商品搜索结果获取，支持排序、仅看带图评价和分页令牌。

POST /socialdatax/api/v1/xhs/product/review/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

sku_id（必填）：小红书商品 SKU ID；用户已提供完整 sku_id 时原样使用，否则可从商品搜索结果复制。不支持 spu_id、商品链接或搜索关键词。
page_token：商品评价分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一商品 SKU、排序、图片筛选和调用方的商品评价链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
sort_type：商品评价排序方式，可选：general（综合，默认）、time_descending（最新评价优先）
has_image：是否只返回带图片的商品评价

请求示例

{
  "sku_id": "691c1de31896c300014f6ea8",
  "page_token": "",
  "sort_type": "general",
  "has_image": false
}

返回字段

items（必填）：当前页商品评价列表
next_page_token（必填）：下一页不透明商品评价分页令牌；items 为空时仍应继续翻页；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一商品 SKU、排序、图片筛选和调用方的商品评价链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "content": "评价内容",
      "like_count": 3,
      "review_id": "498254417103766817",
      "publish_time_text": "2025-06-13",
      "image_items": [
        {
          "image_url": "https://example.invalid/review.webp",
          "thumbnail_url": "https://example.invalid/review-thumb.webp",
          "width": 3024,
          "height": 4032
        }
      ],
      "product_score": 5,
      "logistics_score": 4,
      "service_score": 5,
      "purchased_variants": [
        {
          "name": "颜色分类",
          "value": "经典款"
        }
      ],
      "author": {
        "user_id": "5decf8630000000001003d5f",
        "name": "小红书用户",
        "avatar_url": "https://example.invalid/avatar.webp",
        "profile_url": "https://www.xiaohongshu.com/user/profile/5decf8630000000001003d5f"
      }
    }
  ],
  "next_page_token": "<完整分页令牌>",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书商品评价回复

根据 review_id 读取商品评价回复；已有 ID 时直接使用，否则从 xhs_get_product_reviews 返回的 review_id 获取。支持 page_token 翻页，不接受 root_review_id。

POST /socialdatax/api/v1/xhs/product/review/reply/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

review_id（必填）：一级商品评价 ID；用户已提供时原样使用，否则可从 xhs_get_product_reviews 的 items[*].review_id 原样复制。不支持 root_review_id。
page_token：商品评价回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一一级评价和调用方，不能跨链路复用。

请求示例

{
  "review_id": "498254417103766817",
  "page_token": ""
}

返回字段

items（必填）：当前页商品评价回复列表
next_page_token（必填）：下一页不透明商品评价回复分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须原样传回，只能用于同一一级评价和调用方。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书商品评价嵌套回复

根据 review_id 读取商品评价嵌套回复；已有 ID 时直接使用，否则从 xhs_get_product_review_replies 返回的 review_id 获取。支持 page_token 翻页，不接受 root_review_id。

POST /socialdatax/api/v1/xhs/product/review/reply/reply/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

review_id（必填）：商品评价回复 ID；用户已提供时原样使用，否则可从 xhs_get_product_review_replies 的 items[*].review_id 原样复制。不支持 root_review_id。
page_token：商品评价回复的回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一父级回复和调用方，不能跨链路复用。

请求示例

{
  "review_id": "498254417103766817",
  "page_token": ""
}

返回字段

items（必填）：当前页商品评价回复的回复列表
next_page_token（必填）：下一页不透明商品评价回复的回复分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须原样传回，只能用于同一父级回复和调用方。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书笔记详情

按笔记 ID、笔记链接、短链接或分享文案读取公开笔记详情，返回正文、媒体摘要、互动指标和作者信息。

POST /socialdatax/api/v1/xhs/note/detail

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

note_id：小红书笔记 ID。已有完整 note_id 时原样使用，否则可从笔记搜索结果、笔记详情、评论、标签页笔记列表或用户发帖列表复制；不得截断、缩写或只传前缀
note_url：小红书笔记链接、短链接或分享文案。

请求示例

{
  "note_id": "69e71b110000000022029e5e"
}

返回字段

note_id（必填）：小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。
note_url（必填）：note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。无法提供可用链接时为 null；note_url 为 null 时不要用 note_id 合成公开链接。
note_type（必填）：笔记类型；当前公开值固定为 image 或 video
title（必填）：笔记标题
content（必填）：笔记正文
cover_image_url（必填）：统一封面图
image_items（必填）：图片结构化明细；每项都表示一张图片，Live 图会在对应项携带 live_photo 摘要
video（必填）：视频摘要信息；无可用视频摘要时为 null
like_count（必填）：点赞数
collect_count（必填）：收藏数
comment_count（必填）：评论数
share_count（必填）：分享数
publish_time（必填）：发布时间，秒级 Unix 时间戳
update_time（必填）：更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null
ip_location（必填）：笔记发布时的 IP 属地；没有 IP 属地时为空字符串
topic_tags（必填）：笔记详情中的话题标签；无话题时为空数组
mentioned_users（必填）：笔记正文中 @ 到的用户列表；无 @ 时为空数组
author（必填）：作者信息；详情页不返回小红书号
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "note_id": "69e71b110000000022029e5e",
  "note_url": "https://www.xiaohongshu.com/discovery/item/69e71b110000000022029e5e?xsec_source=app_share&xsec_token=CB8LYwuNCmdLCh4IingDx12rfddpSYoSu-dkiRRHnsk6o=",
  "note_type": "image",
  "title": "露营装备清单",
  "content": "周末露营可以从这几类装备开始准备。",
  "cover_image_url": "https://example.invalid/cover.webp",
  "image_items": [
    {
      "image_url": "https://example.invalid/1.webp",
      "width": 1200,
      "height": 1600,
      "live_photo": null
    }
  ],
  "video": null,
  "like_count": 120,
  "collect_count": 35,
  "comment_count": 18,
  "share_count": 4,
  "publish_time": 1714316800,
  "update_time": null,
  "ip_location": "上海",
  "topic_tags": [
    {
      "name": "露营",
      "id": "topic-1"
    }
  ],
  "mentioned_users": [
    {
      "user_id": "mentioned-user-1",
      "name": "装备清单"
    }
  ],
  "author": {
    "user_id": "67c25fdc000000000a03dae1",
    "name": "露营研究员",
    "avatar_url": "https://example.invalid/avatar.webp",
    "profile_url": "https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1"
  },
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书蒲公英单篇笔记详情

按 note_id 或小红书笔记链接、短链接、分享文案读取蒲公英单篇笔记商业增强详情，返回正文、图片或视频摘要、作者、曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。这是蒲公英商业口径数据，不等同普通公开笔记详情；只支持查询单篇笔记，不支持博主全量笔记汇总。仅适用于已入驻蒲公英博主的笔记；note_id 与 note_url 必须且只能提供一个。查询明确无商业合作数据时按博主未入驻处理，HTTP 200 返回 code=1009；不要换 ID/链接入口重试。普通详情需求使用普通笔记详情接口；超时、鉴权失败、余额不足等不归为未入驻，按各自错误码处理。成功调用扣减 20 积分，失败不扣费。

POST /socialdatax/api/v1/xhs/pgy/note/detail

1 积分 = 0.01 元；成功调用扣减 20 积分，失败不扣费。

请求参数

note_id：小红书笔记 ID。已有完整 note_id 时原样使用，否则可从笔记搜索结果、笔记详情、评论、标签页笔记列表或用户发帖列表复制；不得截断、缩写或只传前缀
note_url：小红书笔记链接、短链接或包含链接的分享文案；与 note_id 必须且只能提供一个

请求示例

{
  "note_url": "https://www.xiaohongshu.com/discovery/item/69e71b110000000022029e5e?xsec_source=app_share&xsec_token=CB8LYwuNCmdLCh4IingDx12rfddpSYoSu-dkiRRHnsk6o="
}

返回字段

note_id（必填）：小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。
note_url（必填）：note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。
title（必填）：蒲公英笔记标题
note_type（必填）：笔记类型；当前公开值固定为 image 或 video
content（必填）：笔记正文
cover_image_url（必填）：统一封面图
image_items（必填）：静态图片明细；不包含 Live 图视频摘要，需要 Live 视频时使用普通笔记详情接口
video（必填）：视频摘要信息；视频笔记返回对象，图文笔记为 null
publish_time（必填）：发布时间，秒级 Unix 时间戳
update_time（必填）：更新时间，秒级 Unix 时间戳
exposure_count（必填）：笔记曝光量
read_count（必填）：笔记阅读量
like_count（必填）：点赞数
collect_count（必填）：收藏数
comment_count（必填）：评论数
share_count（必填）：分享数
author（必填）：作者信息；详情页不返回小红书号
picture_price（必填）：创作者图文笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作
video_price（必填）：创作者视频笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "note_id": "69e71b110000000022029e5e",
  "note_url": "https://www.xiaohongshu.com/explore/69e71b110000000022029e5e?xsec_token=MBPpYmgkjRzcWEXOsJtmi8jLzAoMgQHfeBuLbeLK8f3Js=&xsec_source=pc_pgy",
  "title": "塌屁股你的兵来了！五一出游穿哪条提臀裤啊",
  "note_type": "image",
  "content": "五一准备出去旅游，买了好多漂亮衣服打算狠狠出片！",
  "cover_image_url": "http://ci.xiaohongshu.com/1040g2sg31v7c8et7igkg5pu2bve2nmn1jvn0ri8?imageView2/2/w/1080/format/jpg",
  "image_items": [
    {
      "image_url": "http://ci.xiaohongshu.com/1040g2sg31v7c8et7igkg5pu2bve2nmn1jvn0ri8?imageView2/2/w/1080/format/jpg",
      "width": 2856,
      "height": 5712
    }
  ],
  "video": null,
  "publish_time": 1776753951,
  "update_time": 1777019348,
  "exposure_count": 1492415,
  "read_count": 233465,
  "like_count": 5477,
  "collect_count": 1222,
  "comment_count": 22,
  "share_count": 419,
  "author": {
    "user_id": "67c25fdc000000000a03dae1",
    "name": "小微微💞",
    "avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31vjv8bct2i4g5pu2bve2nmn127ariag?imageView2/2/w/120/format/jpg",
    "profile_url": "https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1"
  },
  "picture_price": 150,
  "video_price": 150,
  "points": {
    "cost": 20,
    "balance": 980
  }
}

读取小红书蒲公英创作者档案

根据完整 user_id 查询蒲公英创作者资料、粉丝数、商业笔记数、合作行业、近 30 天合作笔记数、笔记阅读与互动中位数、内容分类、特征标签和创作者图文/视频合作报价。普通账号资料使用用户信息接口；创作者笔记表现使用蒲公英创作者笔记表现工具；粉丝画像使用蒲公英创作者粉丝画像接口；指标随日期变化使用创作者指标趋势接口。HTTP 和 MCP 成功都直接返回档案字段和 points，不包 data。成功调用扣减 20 积分，失败不扣费。图文和视频报价单位为人民币元；零值不表示免费合作。

POST /socialdatax/api/v1/xhs/pgy/creator/profile

1 积分 = 0.01 元；成功调用扣减 20 积分，失败不扣费。

请求参数

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。

请求示例

{
  "user_id": "67c25fdc000000000a03dae1"
}

返回字段

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
name（必填）：创作者昵称；上游未提供时为 null
red_id（必填）：公开小红书号；缺失时为空字符串，不能作为 user_id 使用
avatar_url（必填）：头像地址；缺失时为 null
profile_url（必填）：由 user_id 生成的用户主页地址
location（必填）：创作者资料所在地，不是 IP 属地；缺失时为 null
gender（必填）：创作者性别：male 表示男，female 表示女；无法确认时为 null
follower_count（必填）：蒲公英口径粉丝数，单位人；未知时为 null
business_note_count（必填）：商业笔记数；未知时为 null
cooperation_industries（必填）：合作行业名称列表；未知时为 null，明确为空时为 []
cooperation_note_count_30d（必填）：近 30 天合作笔记数；未知时为 null
note_read_median（必填）：蒲公英口径笔记阅读数中位数；未知时为 null
received_like_and_collect_count（必填）：获赞与收藏合计；不能拆算为独立点赞数或收藏数；未知时为 null
note_interaction_median（必填）：蒲公英口径笔记互动数中位数；具体互动构成以上游口径为准；未知时为 null
content_categories（必填）：内容分类；未知时为 null，明确为空时为 []
feature_tags（必填）：创作者特征标签；不是主页标签；未知时为 null，明确为空时为 []
picture_price（必填）：创作者图文笔记合作报价，单位：人民币元；未知时为 null，零值不表示免费合作
video_price（必填）：创作者视频笔记合作报价，单位：人民币元；未知时为 null，零值不表示免费合作
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "user_id": "67c25fdc000000000a03dae1",
  "name": "示例创作者",
  "red_id": "26752930781",
  "avatar_url": "https://example.invalid/avatar.jpg",
  "profile_url": "https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1",
  "location": "湖北 武汉 江夏区",
  "gender": "female",
  "follower_count": 3048,
  "business_note_count": 225,
  "cooperation_industries": [
    "3c及电器",
    "日用百货",
    "母婴",
    "食品饮料",
    "服装配饰",
    "医疗健康",
    "美妆个护"
  ],
  "cooperation_note_count_30d": 18,
  "note_read_median": 1279,
  "received_like_and_collect_count": 116911,
  "note_interaction_median": 237,
  "content_categories": [
    {
      "category": "健康养生",
      "subcategories": []
    }
  ],
  "feature_tags": [
    "测评",
    "油皮"
  ],
  "picture_price": 150,
  "video_price": 150,
  "points": {
    "cost": 20,
    "balance": 980
  }
}

读取蒲公英创作者笔记表现

根据 user_id 和 note_scope 读取日常或合作笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和最近笔记明细。固定近30日、图文＋视频、全流量，不支持自选日期或笔记类型；明细最多 15 篇，不是全量列表。仅 notes[] 内的笔记级 *_benchmark_rate 表示相较于平台中位数的相对差异，允许负数和超过 1，不是排名比例；汇总层同名字段仍是平台返回的 0 到 1 对比值，计算方式未公开，不能混用。商业汇总与成本参考使用商业概览接口。HTTP 和 MCP 成功响应都直接返回业务字段和 points，不包 data。成功调用扣减 20 积分，失败不扣费。

POST /socialdatax/api/v1/xhs/pgy/creator/notes/performance

1 积分 = 0.01 元；成功调用扣减 20 积分，失败不扣费。

请求参数

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
note_scope：笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径

请求示例

{
  "user_id": "67c25fdc000000000a03dae1"
}

返回字段

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
note_scope（必填）：笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径
note_count（必填）：统计范围内笔记数；未知时为 null
video_note_count（必填）：统计范围内视频笔记数；未知时为 null
hundred_like_ratio（必填）：获赞不少于 100 的笔记占比，0.1 表示 10%；未知时为 null
thousand_like_ratio（必填）：获赞不少于 1000 的笔记占比，0.1 表示 10%；未知时为 null
content_tags（必填）：笔记内容标签分布；返回标签不保证覆盖全部内容，占比之和不保证为 1；不要自行归一化或补齐其他类别；未知时为 null，明确为空时为 []
impression_median（必填）：笔记曝光量中位数；未知时为 null
impression_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null
read_median（必填）：笔记阅读量中位数；未知时为 null
read_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null
interaction_median（必填）：平台汇总口径的笔记互动量中位数；不保证与 notes[].interaction_count 的统计口径一致，不可直接用返回的笔记明细复算；未知时为 null
interaction_rate（必填）：平台返回的笔记互动率，0.195 表示 19.5%；本响应未提供可确认的计算分母和完整统计口径，不可用返回计数自行复算；未知时为 null
interaction_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null
like_median（必填）：笔记点赞量中位数；未知时为 null
collect_median（必填）：笔记收藏量中位数；未知时为 null
comment_median（必填）：笔记评论量中位数；未知时为 null
share_median（必填）：笔记分享量中位数；未知时为 null
video_full_view_rate（必填）：视频完播率，0.195 表示 19.5%；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示完播率为 0%；未知时为 null
video_full_view_benchmark_rate（必填）：平台返回的视频完播指标对比值，范围 0~1；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示表现为 0；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null
image_3s_view_rate（必填）：图文笔记 3 秒阅读率，0.195 表示 19.5%；仅在统计范围内有图文笔记时用于表现判断；否则 0 值不表示 3 秒阅读率为 0%；未知时为 null
notes（必填）：统计范围内最近发布的最多 15 篇笔记表现明细，不是全量列表；未知时为 null，明确为空时为 []
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "user_id": "67c25fdc000000000a03dae1",
  "note_scope": "daily",
  "note_count": 1,
  "video_note_count": 0,
  "hundred_like_ratio": 1,
  "thousand_like_ratio": 0,
  "content_tags": [
    {
      "tag": "护肤",
      "ratio": 1
    }
  ],
  "impression_median": 12437,
  "impression_benchmark_rate": 0.97,
  "read_median": 1279,
  "read_benchmark_rate": 0.952,
  "interaction_median": 237,
  "interaction_rate": 0.195,
  "interaction_benchmark_rate": 0.984,
  "like_median": 146,
  "collect_median": 91,
  "comment_median": 0,
  "share_median": 12,
  "video_full_view_rate": 0,
  "video_full_view_benchmark_rate": 0,
  "image_3s_view_rate": 1,
  "notes": [
    {
      "note_id": "6aa63fb9000000000b00d8e5",
      "publish_date": "2026-09-13",
      "note_type": "image",
      "thumbnail_url": "https://example.invalid/note.jpg",
      "title": "温柔肤感，是简单的护肤仪式感",
      "impression_count": 12437,
      "impression_benchmark_rate": 0,
      "read_count": 1279,
      "read_benchmark_rate": 0,
      "interaction_count": 249,
      "interaction_benchmark_rate": 0.05,
      "collect_count": 91,
      "like_count": 146,
      "collect_benchmark_rate": 0,
      "like_benchmark_rate": 0
    }
  ],
  "points": {
    "cost": 20,
    "balance": 980
  }
}

读取蒲公英创作者粉丝画像

根据完整 user_id 读取粉丝年龄、性别、地域、城市、兴趣和设备品牌分布及数据日期。比例为 0 到 1 的小数；各分布不保证完整或互斥，不归一化、不补其他类别、不推算人数。使用平台默认统计范围，不支持指定日期。粉丝规模、增长和活跃情况使用粉丝汇总接口；创作者资料和报价使用档案接口。HTTP 和 MCP 成功直接返回画像字段和 points，不包 data。成功调用扣减 20 积分，失败不扣费。

POST /socialdatax/api/v1/xhs/pgy/creator/fans/profile

1 积分 = 0.01 元；成功调用扣减 20 积分，失败不扣费。

请求参数

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。

请求示例

{
  "user_id": "67c25fdc000000000a03dae1"
}

返回字段

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
data_date（必填）：平台标注的数据日期（YYYY-MM-DD），不代表查询时间或统计起止范围；未知时为 null
age_distribution（必填）：粉丝年龄分布；保留平台年龄区间标签，不推断端点含义；不保证完整，未知时为 null，明确为空时为 []
gender_distribution（必填）：粉丝性别分布；不推算缺失占比，未知时为 null
interest_distribution（必填）：粉丝兴趣分布；不保证分类完整或互斥，不用占比之和推算其他兴趣；未知时为 null，明确为空时为 []
region_distribution（必填）：粉丝地域分布；标签可包含省份、中国、海外等，不统一视为省份；不保证完整，未知时为 null，明确为空时为 []
city_distribution（必填）：平台返回的粉丝城市分布；不保证列出全部城市，不重新归一化或补其他；未知时为 null，明确为空时为 []
device_distribution（必填）：粉丝设备品牌分布；不保证列出全部品牌，不重新归一化或补其他；未知时为 null，明确为空时为 []
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "user_id": "67c25fdc000000000a03dae1",
  "data_date": "2026-09-18",
  "age_distribution": [
    {
      "label": "18-24",
      "ratio": 0.1934398654331371
    }
  ],
  "gender_distribution": {
    "male_ratio": 0.16989066442388562,
    "female_ratio": 0.8301093355761143
  },
  "interest_distribution": [
    {
      "label": "美食",
      "ratio": 0.09759016916693265
    }
  ],
  "region_distribution": [
    {
      "label": "广东",
      "ratio": 0.12964969302997473
    }
  ],
  "city_distribution": [
    {
      "label": "北京",
      "ratio": 0.05236547490068617
    }
  ],
  "device_distribution": [
    {
      "name": "apple inc.",
      "display_name": "苹果",
      "ratio": 0.39039364391477066
    }
  ],
  "points": {
    "cost": 20,
    "balance": 980
  }
}

读取蒲公英创作者粉丝汇总

根据完整 user_id 获取蒲公英粉丝总数、平台增长指标、活跃、阅读和互动粉丝人数及占比。粉丝构成使用粉丝画像接口。仅接受 user_id，不支持指定日期或统计周期；增长周期及统计窗口截止日期未提供，不能按查询日期推算。保留平台比例精度，不用人数复算占比，不将不同人群相加。HTTP/MCP 成功直接返回汇总字段和 points，不包 data。成功调用扣减 20 积分，失败不扣费。

POST /socialdatax/api/v1/xhs/pgy/creator/fans/summary

1 积分 = 0.01 元；成功调用扣减 20 积分，失败不扣费。

请求参数

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。

请求示例

{
  "user_id": "67c25fdc000000000a03dae1"
}

返回字段

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
follower_count（必填）：蒲公英口径粉丝总数，单位人；未知时为 null
follower_growth_count（必填）：平台返回的粉丝增长数量；统计周期及是否扣除流失未明确，不可直接解释为近 30 天新增关注人数或净增人数；未知时为 null
follower_growth_rate（必填）：平台返回的粉丝增长率，0.1 表示 10%；不是粉丝构成占比，不限于 0–1。统计周期和计算基数未明确，不用返回人数复算；未知时为 null
active_follower_count_28d（必填）：平台 28 天统计窗口内的活跃粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；活跃判定按平台口径，不等同阅读或互动人数；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null
active_follower_ratio（必填）：平台返回的活跃粉丝占比，0.419 表示 41.9%；保留平台精度，分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null
engaged_follower_count_30d（必填）：平台 30 天统计窗口内的互动粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；不是互动次数，具体互动构成按平台口径；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null
engaged_follower_ratio（必填）：平台返回的互动粉丝占比，0.1 表示 10%；保留平台精度，0 不表示互动人数一定为 0；分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null
read_follower_count_30d（必填）：平台 30 天统计窗口内的阅读粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；不是阅读次数；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null
read_follower_ratio（必填）：平台返回的阅读粉丝占比，0.001 表示 0.1%；保留平台精度，分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "user_id": "67c25fdc000000000a03dae1",
  "follower_count": 3048,
  "follower_growth_count": 1,
  "follower_growth_rate": 0,
  "active_follower_count_28d": 1277,
  "active_follower_ratio": 0.419,
  "engaged_follower_count_30d": 1,
  "engaged_follower_ratio": 0,
  "read_follower_count_30d": 3,
  "read_follower_ratio": 0.001,
  "points": {
    "cost": 20,
    "balance": 980
  }
}

获取蒲公英创作者指标趋势

观察曝光、阅读、互动中位数及预估成本随日期变化时使用。中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，不支持自选日期。合作口径包含进店指标，日常口径的进店字段为 null；输出回显口径，不能混用。指标不是每日新增量或累计总量，不可跨日期求和；缺失日期不补零。历史点的具体滚动窗口未明确。成本估算口径见字段说明，不代表实际成交成本；按图文/视频拆分的成本及商业汇总使用商业概览工具，逐篇表现使用笔记表现工具。成功直接返回业务字段及 points，不包 data；成功扣 20 积分，失败不扣费。

POST /socialdatax/api/v1/xhs/pgy/creator/metrics/trend

1 积分 = 0.01 元；成功调用扣减 20 积分，失败不扣费。

请求参数

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
note_scope：笔记统计口径：日常笔记趋势选 daily（默认，不是按天汇总）；合作笔记或进店趋势选 cooperation。输出回显口径，不可混用；成本估算依据见各字段说明

请求示例

{
  "user_id": "67c25fdc000000000a03dae1"
}

返回字段

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
note_scope（必填）：笔记统计口径：日常笔记趋势选 daily（默认，不是按天汇总）；合作笔记或进店趋势选 cooperation。输出回显口径，不可混用；成本估算依据见各字段说明
summary（必填）：平台提供的概览指标及其日期，不是趋势各点之和；缺失时为 null
items（必填）：平台返回的日期序列；中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，成本口径见各字段说明；可能缺少日期，不补零、不插值；未知时为 null，明确为空时为 []
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "user_id": "67c25fdc000000000a03dae1",
  "note_scope": "daily",
  "summary": {
    "date": "2026-09-18",
    "impression_median": 12437,
    "read_median": 1279,
    "interaction_median": 249,
    "estimated_cpm": 12.060786363270886,
    "estimated_interaction_cost": 0.6024096385542169,
    "estimated_read_cost": null,
    "outbound_store_visit_median": null,
    "estimated_store_visit_cost": null
  },
  "items": [
    {
      "date": "2026-09-17",
      "impression_median": 12422,
      "read_median": 1277,
      "interaction_median": 248,
      "estimated_cpm": 12.075350185155369,
      "estimated_interaction_cost": 0.6048387096774194,
      "estimated_read_cost": null,
      "outbound_store_visit_median": null,
      "estimated_store_visit_cost": null
    },
    {
      "date": "2026-09-18",
      "impression_median": 12437,
      "read_median": 1279,
      "interaction_median": 249,
      "estimated_cpm": 12.060786363270886,
      "estimated_interaction_cost": 0.6024096385542169,
      "estimated_read_cost": null,
      "outbound_store_visit_median": null,
      "estimated_store_visit_cost": null
    }
  ],
  "points": {
    "cost": 20,
    "balance": 980
  }
}

读取蒲公英创作者商业概览

读取笔记规模和中位数、服务表现、增长、平台标签、预估成本及对比值。仅接受完整 user_id 和 note_scope：日常内容选 daily（默认，不是按天汇总），商单、品牌合作笔记或外溢进店选 cooperation；输出回显口径；不是对全部字段统一筛选，note_count 不能解释为所选口径的笔记数。本接口只返回汇总，不返回逐篇明细。逐篇表现使用创作者笔记表现接口，也可选择日常或合作口径。合作口径才返回外溢进店指标，日常口径对应字段为 null。两种口径的成本估计依据不同，不代表实际成交成本或ROI。统计截止日期未提供，不支持指定日期；进店不等于订单或成交，不据此推断调用方自己的投放成绩。HTTP/MCP 成功直接返回业务字段及 points，不包 data；成功扣 20 积分，失败不扣费。

POST /socialdatax/api/v1/xhs/pgy/creator/commercial/overview

1 积分 = 0.01 元；成功调用扣减 20 积分，失败不扣费。

请求参数

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
note_scope：笔记统计口径：查看日常内容表现选 daily（默认），不是按天汇总；查看商单、品牌合作笔记或外溢进店表现选 cooperation；输出回显实际口径，不能混用；不表示所有字段均按此口径拆分，note_count 等字段按各自说明解读

请求示例

{
  "user_id": "67c25fdc000000000a03dae1",
  "note_scope": "cooperation"
}

返回字段

user_id（必填）：小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
note_scope（必填）：笔记统计口径：查看日常内容表现选 daily（默认），不是按天汇总；查看商单、品牌合作笔记或外溢进店表现选 cooperation；输出回显实际口径，不能混用；不表示所有字段均按此口径拆分，note_count 等字段按各自说明解读
data_date（必填）：平台标注的数据日期（YYYY-MM-DD）；不代表查询时间或各指标统计截止日期；未知时为 null
invitation_count（必填）：平台返回的邀约数量；统计周期、邀约方向及状态范围未明确，不等于成交或成功合作数量；未知时为 null
response_rate（必填）：历史邀约合作消息在 48 小时内回复的比例，0.852 表示 85.2%；48 小时是回复时限，不是统计周期；累计周期和完整分母未提供，不用邀约数推算回复次数；邀约数不足 3 时不用于评价回复表现，不视为合作接受率；未知时为 null
active_days_7d（必填）：平台 7 天统计窗口内登录小红书 App 的天数；截止日期未提供，不按查询日期或 data_date 推算起止日期，不等同发布笔记天数；未知时为 null
industry_labels（必填）：平台 30 天窗口内 TOP2 合作品牌行业；原样保留，不代表全部行业或具体品牌合作清单，不保证与创作者档案同口径；未知时为 null，明确为空时为 []
note_count（必填）：平台 30 天窗口内发布笔记数；不能因 note_scope=daily/cooperation 就解释为日常/合作笔记数量，不作为所选口径中位数的样本数量；不代表全部历史，截止日期未提供；未知时为 null
read_median（必填）：平台 30 天窗口内所选口径笔记的阅读量中位数，不是累计阅读量；截止日期未提供，不用其他接口明细复算；未知时为 null
interaction_median（必填）：平台 30 天窗口内所选口径笔记的互动量中位数，不是累计互动量；截止日期未提供，互动构成按平台口径，不用其他接口明细复算；未知时为 null
content_tags（必填）：平台 30 天窗口发布笔记的 TOP2 内容类目及笔记数量占比；不代表完整分布，不归一化或补其他，不保证与笔记表现接口同口径；未知时为 null，明确为空时为 []
commercial_label（必填）：平台给出的商业标签原文，仅作平台评价展示，不作为独立评价结论；未知时为 null
commercial_label_description（必填）：平台商业标签说明原文；涉及排名或比较的文字仅代表平台说法，不提取为独立排名或百分位数值；未知时为 null
follower_growth_rate_30d（必填）：平台 30 天统计窗口的粉丝增长率，0.1 表示 10%；不是构成占比，不限于 0–1。截止日期和计算基数未提供，不按查询日期或 data_date 推算窗口，不与其他周期增长率混用；未知时为 null
read_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记中位数，不保证与笔记表现接口同口径
interaction_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记中位数，不保证与笔记表现接口同口径
follower_growth_benchmark_rate_30d（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天粉丝增长指标，窗口截止日期未提供；不是实际粉丝增长率
impression_median（必填）：平台 30 天窗口内所选口径笔记的曝光量中位数，不是累计曝光量；截止日期未提供，不用其他接口明细复算；未知时为 null
impression_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记曝光中位数，不保证与笔记表现接口同口径
estimated_picture_cpm（必填）：平台预估图文 CPM，单位人民币元/千次曝光；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null
estimated_video_cpm（必填）：平台预估视频 CPM，单位人民币元/千次曝光；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null
estimated_picture_read_cost（必填）：平台预估图文阅读单价，单位人民币元/次阅读；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null
estimated_video_read_cost（必填）：平台预估视频阅读单价，单位人民币元/次阅读；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null
estimated_picture_interaction_cost（必填）：平台预估图文互动单价，单位人民币元/次互动；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null
estimated_video_interaction_cost（必填）：平台预估视频互动单价，单位人民币元/次互动；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null
estimated_picture_cpm_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文 CPM，不是实际成本或 ROI；相应预估成本不可用时为 null
estimated_video_cpm_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频 CPM，不是实际成本或 ROI；相应预估成本不可用时为 null
estimated_picture_read_cost_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文阅读单价，不是实际成本或 ROI；相应预估成本不可用时为 null
estimated_video_read_cost_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频阅读单价，不是实际成本或 ROI；相应预估成本不可用时为 null
estimated_picture_interaction_cost_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文互动单价，不是实际成本或 ROI；相应预估成本不可用时为 null
estimated_video_interaction_cost_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频互动单价，不是实际成本或 ROI；相应预估成本不可用时为 null
outbound_store_visit_median（必填）：平台30天合作笔记范围内的外溢进店量中位数；不是累计人数、订单数或成交额，窗口截止日未明确；daily 或未知时为 null
outbound_store_visit_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应合作笔记外溢进店中位数；daily 时为 null
estimated_picture_store_visit_cost（必填）：平台预估图文外溢进店单价，人民币元/进店；依据近30天跨域合作笔记价格及进店UV估计，不是成交成本或ROI；daily、不可预估、零值或未知时为 null
estimated_video_store_visit_cost（必填）：平台预估视频外溢进店单价，人民币元/进店；依据近30天跨域合作笔记价格及进店UV估计，不是成交成本或ROI；daily、不可预估、零值或未知时为 null
estimated_picture_store_visit_cost_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文进店单价，不是实际成本或ROI；daily 或对应成本不可用时为 null
estimated_video_store_visit_cost_benchmark_rate（必填）：平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频进店单价，不是实际成本或ROI；daily 或对应成本不可用时为 null
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "user_id": "67c25fdc000000000a03dae1",
  "note_scope": "cooperation",
  "data_date": "2026-09-27",
  "invitation_count": 29,
  "response_rate": 0.862,
  "active_days_7d": 6,
  "industry_labels": [
    "服装配饰",
    "美妆个护"
  ],
  "note_count": 13,
  "read_median": 1990,
  "interaction_median": 446,
  "content_tags": [
    {
      "tag": "个人护理",
      "ratio": 0.231
    },
    {
      "tag": "护肤",
      "ratio": 0.231
    }
  ],
  "commercial_label": null,
  "commercial_label_description": null,
  "follower_growth_rate_30d": 0,
  "read_benchmark_rate": 0.7221,
  "interaction_benchmark_rate": 0.8841,
  "follower_growth_benchmark_rate_30d": 0,
  "impression_median": 13336,
  "impression_benchmark_rate": 0.6515,
  "estimated_picture_cpm": 16.179051408239943,
  "estimated_video_cpm": 107.15601488648697,
  "estimated_picture_read_cost": 0.43116965907345317,
  "estimated_video_read_cost": 2.127061997745379,
  "estimated_picture_interaction_cost": 0.6241767431545259,
  "estimated_video_interaction_cost": 17.370382047300343,
  "estimated_picture_cpm_benchmark_rate": 0.6216,
  "estimated_video_cpm_benchmark_rate": 0.1201,
  "estimated_picture_read_cost_benchmark_rate": 0.6983,
  "estimated_video_read_cost_benchmark_rate": 0.2031,
  "estimated_picture_interaction_cost_benchmark_rate": 0.7615,
  "estimated_video_interaction_cost_benchmark_rate": 0.066,
  "outbound_store_visit_median": 1,
  "outbound_store_visit_benchmark_rate": 0.4821,
  "estimated_picture_store_visit_cost": 5.096140707973625,
  "estimated_video_store_visit_cost": null,
  "estimated_picture_store_visit_cost_benchmark_rate": 0.4503,
  "estimated_video_store_visit_cost_benchmark_rate": null,
  "points": {
    "cost": 20,
    "balance": 980
  }
}

解析小红书加密用户 ID

根据完整加密用户 ID 获取稳定 user_id。返回的 user_id 可继续用于用户资料或用户笔记接口。

POST /socialdatax/api/v1/xhs/user/id/decrypt

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

encrypted_user_id（必填）：小红书加密用户 ID。用户已提供时直接原样使用；请传入完整 29 位小写十六进制值；不要传 24 位 user_id、小红书号、昵称或主页链接

请求示例

{
  "encrypted_user_id": "a01513967364874bd9aeb7131a293"
}

返回字段

user_id（必填）：稳定用户 user_id
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "user_id": "5c8c53570000000011003f64",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

获取小红书笔记分享链接

按笔记 ID 或链接获取完整分享内容和分享短链接；note_id 与 note_url 必须且只能提供一个。

POST /socialdatax/api/v1/xhs/note/share/link

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

note_id：小红书笔记 ID，与 note_url 必须且只能提供一个。
note_url：小红书笔记页面链接、短链接或包含链接的分享文案，与 note_id 必须且只能提供一个。

请求示例

{
  "note_id": "69e71b110000000022029e5e"
}

返回字段

share_text（必填）：包含分享短链接的完整分享内容，可复制分享。
short_url（必填）：小红书笔记分享短链接。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "share_text": "笔记分享 https://xhslink.cn/o/example",
  "short_url": "https://xhslink.cn/o/example",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

获取小红书分享信息

根据笔记分享短链接或完整分享文案获取分享人、笔记摘要及作者。需要完整内容时使用笔记详情接口；分享信息不包含分享时间。

POST /socialdatax/api/v1/xhs/share/info

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

share_text（必填）：小红书笔记分享短链接，或包含该链接的完整分享文案。

请求示例

{
  "share_text": "https://xhslink.cn/o/example"
}

返回字段

share_user_info（必填）：该链接的分享人；缺失时为 null
note_info（必填）：该链接的笔记摘要及作者；缺失时为 null
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "share_user_info": {
    "user_id": "67c25fdc000000000a03dae1",
    "name": "分享用户",
    "avatar_url": "https://example.invalid/sharer.webp",
    "profile_url": null
  },
  "note_info": {
    "note_id": "69e71b110000000022029e5e",
    "note_type": "image",
    "summary": "两步复刻6款热门奶茶！宅家实现奶茶自由",
    "cover_image_url": "https://example.invalid/cover.webp",
    "author": {
      "user_id": "ae33373e21b0ef7d235fa646c95b7",
      "name": "奶茶研究员",
      "avatar_url": null,
      "profile_url": null
    }
  },
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书用户资料

按用户 ID 或主页链接读取创作者公开资料、认证信息和公开互动规模。

POST /socialdatax/api/v1/xhs/user/info

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

user_id：小红书用户 user_id。用户已提供完整 user_id 时原样使用，否则可从笔记搜索结果、商品评价、商品评价回复、笔记详情、标签页笔记列表、用户信息或用户发帖列表的 user_id/author.user_id 复制；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称
profile_url：小红书用户主页链接。

请求示例

{
  "user_id": "67c25fdc000000000a03dae1"
}

返回字段

user_id（必填）：用户 user_id
name（必填）：用户名称
avatar_url（必填）：用户头像链接；没有头像链接时为 null
profile_url（必填）：用户主页链接；没有主页链接时为 null
red_id（必填）：用户公开小红书号；没有小红书号时为空字符串
bio（必填）：用户个人简介（biography）；没有简介时为空字符串
verified（必填）：是否已认证
verification_category（必填）：认证补充信息；可能是行业类目或认证主体名称；未认证或没有认证信息时为空字符串
is_professional_account（必填）：是否为专业号
verification_name（必填）：认证主体名称；没有认证主体时为空字符串
is_enterprise_account（必填）：是否为企业账号
profile_tags（必填）：主页头部标签名称列表；没有标签时为空数组
follower_count（必填）：粉丝数
following_count（必填）：关注数
posted_note_count（必填）：已发布笔记数
received_like_count（必填）：用户内容累计收到的点赞数
received_collect_count（必填）：用户内容累计被收藏数
ip_location（必填）：用户 IP 属地；没有 IP 属地时为空字符串
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "user_id": "67c25fdc000000000a03dae1",
  "name": "露营研究员",
  "avatar_url": "https://example.invalid/avatar.webp",
  "profile_url": "https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1",
  "red_id": "camp-001",
  "bio": "记录露营和户外装备。",
  "verified": true,
  "verification_category": "户外",
  "is_professional_account": true,
  "verification_name": "户外样例企业有限公司",
  "is_enterprise_account": true,
  "profile_tags": [
    "户外",
    "品牌主理人"
  ],
  "follower_count": 12000,
  "following_count": 80,
  "posted_note_count": 128,
  "received_like_count": 300000,
  "received_collect_count": 90000,
  "ip_location": "上海",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书用户笔记列表

按用户 ID 或主页链接读取创作者已发布笔记摘要列表，支持分页令牌。

POST /socialdatax/api/v1/xhs/user/note/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

user_id：小红书用户 user_id。用户已提供完整 user_id 时原样使用，否则可从笔记搜索结果、商品评价、商品评价回复、笔记详情、标签页笔记列表、用户信息或用户发帖列表的 user_id/author.user_id 复制；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称
profile_url：小红书用户主页链接。
page_token：分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。

请求示例

{
  "user_id": "67c25fdc000000000a03dae1",
  "page_token": ""
}

返回字段

items（必填）：当前页用户发帖摘要列表
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "note_id": "69e71b110000000022029e5e",
      "note_url": "https://www.xiaohongshu.com/explore/69e71b110000000022029e5e",
      "note_type": "image",
      "title": "露营装备清单",
      "summary": "适合周末出行的装备组合。",
      "cover_image_url": "https://example.invalid/cover.webp",
      "like_count": 120,
      "collect_count": 35,
      "comment_count": 18,
      "share_count": 4,
      "publish_time": 1714316800,
      "update_time": null,
      "video": null,
      "author": {
        "user_id": "67c25fdc000000000a03dae1",
        "name": "露营研究员",
        "avatar_url": "https://example.invalid/avatar.webp",
        "profile_url": "https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1"
      },
      "is_pinned": false
    }
  ],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书笔记一级评论

按笔记 ID、笔记链接、短链接或分享文案读取公开一级评论，可通过 sort_type 设置评论排序，返回评论作者、内容类型、互动指标和下一页分页令牌。当前笔记不支持请求的排序时返回业务错误码 2001，并通过 available_sort_types 给出可用的公开排序值。

POST /socialdatax/api/v1/xhs/note/comment/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

note_id：小红书笔记 ID。已有完整 note_id 时原样使用，否则可从笔记搜索结果、笔记详情、评论、标签页笔记列表或用户发帖列表复制；不得截断、缩写或只传前缀
note_url：小红书笔记链接、短链接或分享文案。
page_token：分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
sort_type：评论排序方式，可选：default（默认/综合排序）、time_descending（最新评论优先）、like_count_descending（点赞最多优先）

请求示例

{
  "note_id": "69e71b110000000022029e5e",
  "page_token": "",
  "sort_type": "default"
}

返回字段

items（必填）：当前页一级评论列表
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
comment_count（必填）：整篇笔记的总评论数，含一级评论与回复；不是当前页 items 数量
top_level_comment_count（必填）：整篇笔记的一级评论总数，不含回复；不是当前页 items 数量；无法获取时为 null
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "comment_id": "69e85611000000001401c821",
      "note_id": "69e71b110000000022029e5e",
      "content": "这个清单很实用。",
      "content_type": "text",
      "image_items": [],
      "voice_info": null,
      "voice_duration_seconds": null,
      "mentioned_users": [],
      "referenced_notes": [],
      "publish_time": 1714316900,
      "like_count": 8,
      "reply_count": 2,
      "parent_comment_id": null,
      "is_pinned": false,
      "is_author_comment": false,
      "ip_location": "河南",
      "author": {
        "user_id": "ae33373e21b0ef7d235fa646c95b7",
        "name": "D.",
        "avatar_url": "https://example.invalid/comment-avatar.webp",
        "profile_url": null,
        "red_id": "8181415338"
      }
    }
  ],
  "next_page_token": "",
  "comment_count": 18,
  "top_level_comment_count": 12,
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书笔记二级评论

按笔记 ID 和一级评论 ID 读取公开回复列表，返回评论结构和下一页分页令牌。

POST /socialdatax/api/v1/xhs/note/comment/sub/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

note_id（必填）：小红书笔记 ID。已有完整 note_id 时原样使用，否则可从笔记搜索结果、笔记详情、评论、标签页笔记列表或用户发帖列表复制；不得截断、缩写或只传前缀
comment_id（必填）：一级评论 ID。
page_token：分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一 note_id 和 comment_id 的二级评论列表，不能跨笔记或一级评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。

请求示例

{
  "note_id": "69e71b110000000022029e5e",
  "comment_id": "69e85611000000001401c821",
  "page_token": ""
}

返回字段

items（必填）：当前页二级评论列表
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一 note_id 和 comment_id 的二级评论列表，不能跨笔记或一级评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "comment_id": "69e829450000000014018c13",
      "note_id": "69e71b110000000022029e5e",
      "content": "同感，收藏了。",
      "content_type": "text",
      "image_items": [],
      "voice_info": null,
      "voice_duration_seconds": null,
      "mentioned_users": [],
      "referenced_notes": [],
      "publish_time": 1714317000,
      "like_count": 2,
      "reply_count": 0,
      "parent_comment_id": "69e85611000000001401c821",
      "is_pinned": false,
      "is_author_comment": false,
      "ip_location": "湖北",
      "author": {
        "user_id": "ac6b05ef915d2f2b1bfb67c176475",
        "name": "小微微💞",
        "avatar_url": "https://example.invalid/comment-avatar-2.webp",
        "profile_url": null,
        "red_id": "26752930781"
      }
    }
  ],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取小红书标签页笔记列表

按标签页链接 topic_url 或标签页 page_id 读取笔记列表，支持 page_token 与 sort_type，返回下一页分页令牌、总笔记数和总用户数。

POST /socialdatax/api/v1/xhs/topic/note/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

page_id：小红书标签页 page_id。
topic_url：小红书话题页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/topic/normal/... 话题页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。
page_token：分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
sort_type：标签页笔记排序方式，可选：hot（最热，默认）、time_descending（最新）

请求示例

{
  "topic_url": "https://www.xiaohongshu.com/topic/normal/60e27aef15d4f70001dd8d7b",
  "page_token": "",
  "sort_type": "hot"
}

返回字段

items（必填）：标签页笔记列表
next_page_token（必填）：下一页不透明分页令牌；非空表示可尝试请求下一页，为空表示当前没有可继续的下一页令牌。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；items 为空时不要单独据此判断结束；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
total_note_count（必填）：标签页笔记总数
total_user_count（必填）：标签页涉及用户总数
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "note_id": "69e71b110000000022029e5e",
      "note_type": "image",
      "title": "露营地咖啡装备怎么带更省事",
      "cover_image_url": "https://example.invalid/topic-cover.webp",
      "image_items": [
        {
          "image_url": "https://example.invalid/topic-image.webp",
          "width": 1280,
          "height": 1706
        }
      ],
      "video": null,
      "like_count": 120,
      "publish_time": 1714316800,
      "author": {
        "user_id": "67c25fdc000000000a03dae1",
        "name": "露营研究员",
        "avatar_url": "https://example.invalid/avatar.webp",
        "profile_url": "https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1"
      }
    }
  ],
  "next_page_token": "opaque-topic-page-token",
  "total_note_count": 128,
  "total_user_count": 96,
  "points": {
    "cost": 10,
    "balance": 990
  }
}

鉴权与在线测试

业务 API 使用 API Key 鉴权。公开文档无需登录；在线测试可手动输入 API Key，登录后也可选择账户已有 Key。手动输入的 Key 仅在当前页面使用，curl 示例始终引用 SOCIALDATAX_API_KEY 环境变量。

机器可读入口

开发工具和 AI 可以通过以下公共入口读取最新文档，接口数据由后端统一生成。