参数名	类型	必填	说明	示例
key	string	是	接口调用密钥
url	string	是	分享链或者文章链	https://xhslink.cn/o/3VW23QbDtvK

小红书-解析

接口说明

该接口用于解析小红书平台上的图集与视频内容，提供无水印的在线资源获取能力。它面向需要集成小红书内容解析功能的应用或开发者，支持通过分享链接或文章链接直接获取结构化数据，包括图片、视频及元信息。

调用地址

请始终将 https://api.vsaa.cn/api/parser/xiaohongshu/index.php 作为本接口的请求目标地址。该地址已包含站点域名与完整路径，可直接用于 HTTP 客户端配置、前端 SDK 初始化及 API 网关路由，无需追加域名前缀或修改路径结构。

请求方式

本接口支持 GET 与 POST 两种请求方法，可根据客户端实现习惯任选其一：

GET：适用于将全部参数附加于 URL 查询串（query string）的场景，便于直接通过浏览器、curl 或各类轻量级 HTTP 库发起调试与测试。
POST：适用于参数通过请求体（body）传递的场景，符合常规表单提交或 JSON 载荷传输习惯，适用于生产环境中对请求体结构有既定规范的后端服务调用。

两种方法在功能、鉴权逻辑、响应结果上完全一致，不存在方法级的能力差异。

鉴权说明

本接口调用必须携带密钥，未携带或密钥无效将拒绝处理请求。

本站对外提供且首选的鉴权方式为 Query 参数传递：在请求 URL 的查询串中追加参数 key=…，其中 … 为分配给调用方的接口密钥。具体示例如下：

GET https://api.vsaa.cn/api/parser/xiaohongshu/index.php?key=您的密钥&url=https://xhslink.cn/o/3VW23QbDtvK

密钥由平台分配，请妥善保存，避免泄露或硬编码进公开代码库。

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥，通过 Query 参数传递
url	string	是	小红书分享链接或文章链接，支持解析图集及视频内容

成功响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "id": "69b8e8c6000000001a0253b5",
    "type": "images",
    "time": 1773725894000,
    "user": {
      "nickname": "何玲律师在上海～",
      "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31tf5gu9sls005n3kog14g01fgcb7vj0",
      "xsecToken": "ABrairCMzPonr2BispwwMUdCV_LZkv3P8xcer5hHUHS8M=",
      "userId": "5c74c402000000001200002f"
    },
    "title": "",
    "location": null,
    "info": {
      "shareCount": 3,
      "followed": false,
      "niceCount": "",
      "liked": false,
      "likedCount": 5,
      "relation": "none",
      "collected": false,
      "collectedCount": 1,
      "commentCount": 8
    },
    "desc": "【上海市第二中级人民法院开庭】\n合议庭：有审判长审判员人民陪审员书记员。阵仗大不愧是到中院的案子排面就是大\n人多热闹一毛钱没花这么多人盛装出席听我发言#上海律师[话题]##庭审[话题]# #上海二中院[话题]# #诉讼[话题]# #律师[话题]#",
    "cover": {
      "width": 4284,
      "height": 5712,
      "url": "http://sns-webpic-qc.xhscdn.com/202610242053/3e53b1cfa2112812f81212394d5c1f85/note_pre_post_uhdr/1040g3r031tq8k3b7n8005n3kog14g01f0gp4lr8!nd_dft_wlteh_webp_3"
    },
    "images": [
      {
        "width": 4284,
        "height": 5712,
        "url": "http://sns-webpic-qc.xhscdn.com/202610242053/3e53b1cfa2112812f81212394d5c1f85/note_pre_post_uhdr/1040g3r031tq8k3b7n8005n3kog14g01f0gp4lr8!nd_dft_wlteh_webp_3"
      },
      {
        "width": 4284,
        "height": 5712,
        "url": "http://sns-webpic-qc.xhscdn.com/202610242053/171d252afd1a01faedc790c332ea24c2/note_pre_post_uhdr/1040g3r031tq8k3b7n80g5n3kog14g01fenp4ad8!nd_dft_wlteh_webp_3"
      },
      {
        "width": 4284,
        "height": 5712,
        "url": "http://sns-webpic-qc.xhscdn.com/202610242053/229bb17bc9f6c1f28906a26b1d8d085f/note_pre_post_uhdr/1040g3r031tq8k3b7n8105n3kog14g01fi0fug70!nd_dft_wlteh_webp_3"
      },
      {
        "width": 4284,
        "height": 5712,
        "url": "http://sns-webpic-qc.xhscdn.com/202610242053/9c122763607671dcdd8edfed1fa4b031/note_pre_post_uhdr/1040g3r031tq8k3b7n81g5n3kog14g01fo77jaf8!nd_dft_wlteh_webp_3"
      },
      {
        "width": 3024,
        "height": 4032,
        "url": "http://sns-webpic-qc.xhscdn.com/202610242053/e69c10c43b7c3cbcc9b63111578d9a53/note_pre_post_uhdr/1040g3r031tq8k3b7n8205n3kog14g01fgcl20lo!nd_dft_wlteh_webp_3"
      }
    ]
  }
}

响应字段说明

字段路径	类型	说明
`code`	integer	状态码，200 表示解析成功。
`message`	string	状态描述信息，成功时为 "success"。
`data`	object	解析成功时返回的详细内容对象。
`data.id`	string	笔记的唯一标识符。
`data.type

错误响应示例

当接口调用失败或业务校验不通过时，将返回如下结构的 JSON 数据：

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

其中：

code：固定为 0，表示业务响应状态。
msg：人类可读的错误提示信息。
errcode：具体的业务错误码，用于程序化处理异常。

业务错误码说明

以下表格列出了本站接口可能返回的全部业务错误码及其含义：

errcode	含义
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	***地址无效
11015	***地址不允许
11016	***请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前IP不在白名单内
11020	启用出口代理须提供有效密钥
11021	未配置可用出口代理
11022	出口代理不可用
11023	密钥已过期
11024	令牌分配积分不足
11025	该密钥无权调用此接口

调用示例

终端 curl（bash）

curl -G "https://api.vsaa.cn/api/parser/xiaohongshu/index.php" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "url=https://xhslink.cn/o/3VW23QbDtvK"

PHP

// PHP 示例
$apiKey = "YOUR_API_KEY";
$urlToParse = "https://xhslink.cn/o/3VW23QbDtvK";

$endpoint = "https://api.vsaa.cn/api/parser/xiaohongshu/index.php";

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => $endpoint,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPGET => true,
    CURLOPT_TIMEOUT => 30,
]);

$paramString = http_build_query([
    'key' => $apiKey,
    'url' => $urlToParse
]);

curl_setopt($ch, CURLOPT_URL, $endpoint . '?' . $paramString);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);

if ($result && $result['code'] === 200) {
    echo "解析成功。\n";
    echo "类型: " . $result['data']['type'] . "\n";
    if (!empty($result['data']['images'])) {
        echo "图片数量: " . count($result['data']['images']) . "\n";
        foreach ($result['data']['images'] as $img) {
            echo "- " . $img['url'] . "\n";
        }
    }
} else {
    echo "解析失败或无数据。\n";
}

注意事项

密钥安全：密钥必须严格保密，禁止在前端代码、公共仓库或客户端中明文暴露。仅在服务端环境存储与调用，防止因密钥泄露导致接口被滥用。
频率限制：该接口限制为每分钟约 56 次请求。高频批量解析时请增加重试间隔或实现队列机制，避免触发限流导致请求失败。
链接有效性：url 参数需传入有效的小红书分享短链或文章链接。链接过期、失效或格式错误时将无法获取解析结果，建议在调用前校验链接合法性。
HTTPS 调用：始终通过 HTTPS 协议发起请求，确保密钥及传输数据在链路中的加密安全，防止中间人窃听。
内容合规：解析返回的图片与视频资源受版权保护，仅限个人学习或合法商业用途，禁止大规模抓取、转售或用于侵权内容生产。

免责声明

欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。

1. 本平台仅提供**技术接口与数据聚合服务**，不存储、不生产、不拥有任何原始数据内容。 2. 本平台所返回的数据均来源于公开网络或第三方接口，仅作**技术学习、研究与交流**之用。 3. 本平台不保证任何接口的**持续可用性、准确性、完整性或及时性**，接口可能因第三方原因随时变更、中断或停止。 1. 使用者应遵守中华人民共和国相关法律法规，以及其所在地的所有适用法律。 2. **禁止**将本平台接口用于任何违法违规用途，包括但不限于： - 侵犯他人知识产权、隐私权或其他合法权益； - 从事网络攻击、数据爬取滥用、恶意刷量等行为； - 传播违法、有害、虚假或不良信息； - 用于任何商业转售、二次分发而未获授权的情形。 3. 使用者应自行承担因使用本平台服务而产生的一切后果与法律责任。 1. 本平台**不收集、不存储**使用者的个人敏感信息。 2. 使用者通过接口提交的查询参数，仅用于当次请求处理，不做持久化留存。 3. 若接口涉及第三方数据，其版权与解释权归原数据方所有，本平台不承担相关争议责任。 1. 本平台以**“现状”**和**“现有”**为基础提供服务，不对服务作出任何明示或暗示的担保。 2. 因使用或无法使用本平台服务而导致的任何**直接、间接、偶然或必然损失**，本平台及其运营者均不承担任何责任。 3. 因不可抗力、网络故障、第三方服务中断、政策调整等原因导致的服务异常，本平台不承担责任。 1. 本平台的接口设计、文档、代码及相关标识，其知识产权归本平台所有。 2. 未经书面许可，任何单位或个人不得复制、修改、传播或用于商业用途。 1. 本平台有权随时修改本免责声明，修改后的内容将在本页面公布，不再另行通知。 2. 使用者应定期查阅本声明，继续使用即视为接受变更后的条款。 1. 本声明的最终解释权归 **万象数据API** 所有。 2. 如您不同意本声明的任何内容，请立即停止使用本平台服务。 3. 如因本声明产生争议，双方应友好协商解决；协商不成的，可提交本平台运营者所在地有管辖权的人民法院裁决。

最后更新日期：2026年10月6日

小红书-解析

接口信息

请求参数

返回示例

详细文档

小红书-解析

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

新闻联播