当前位置：首页 > news >正文

小红书开放平台获取笔记评论API接口指南（2025年最新版）

news 2025/10/26 12:11:26

一、核心流程：从认证到调用

注册与实名认证
- 访问小红书开放平台，使用手机号/邮箱注册开发者账号，完成企业资质或个人身份认证（需上传营业执照或身份证扫描件）。
- 登录后进入「控制台」→「应用管理」，创建新应用并填写应用名称、类型（如数据分析工具、内容管理平台），提交后等待1-3个工作日审核。
申请API权限
- 审核通过后，在应用管理页面点击「接口权限」→「申请权限」，选择“笔记详情API”或“评论API”（如v2/notes/{note_id}/comments）。
- 填写申请理由（如“用于内容分析工具开发”），提交后等待1-5个工作日二次审核。通过后获取App Key、App Secret及access_token（有效期通常为2小时，需通过OAuth2.0刷新）。
接口调用参数与地址
- 接口地址：https://api.xiaohongshu.com/v2/notes/{note_id}/comments（需替换{note_id}为实际笔记ID，可从笔记URL或分享链接提取）。
- 必填参数：
  - note_id：笔记唯一标识符（如649c46ab000000002702ad36）。
  - access_token：通过认证获取的访问令牌。
  - page：分页页码（默认1），page_size：每页评论数（默认10，上限100）。
- 可选参数：timestamp（时间戳）、sign（MD5签名，需用App Key+App Secret+参数生成）。

Python调用示例

python

import requests
import hashlib
import timedef get_comments(note_id, access_token, page=1, page_size=10):url = f"https://api.xiaohongshu.com/v2/notes/{note_id}/comments"timestamp = str(int(time.time()))# 生成签名（示例，需替换实际App Key/Secret）sign_str = "YOUR_APP_KEY" + note_id + str(page) + str(page_size) + timestamp + "YOUR_APP_SECRET"sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest()params = {"access_token": access_token,"page": page,"page_size": page_size,"timestamp": timestamp,"sign": sign}response = requests.get(url, params=params)if response.status_code == 200:return response.json()else:raise Exception(f"请求失败: {response.text}")# 示例调用
note_id = "123456789"
access_token = "YOUR_ACCESS_TOKEN"
comments = get_comments(note_id, access_token)
print(comments["data"]["comments"][0]["content"])  # 输出第一条评论内容

二、关键注意事项

频率限制与错误处理
- 频率限制：每分钟≤100次，超限触发429错误。建议采用缓存+重试机制（如首次重试延迟1秒，二次2秒，依此类推）。
- 错误码处理：
  - 401：未授权（检查access_token有效性）。
  - 404：笔记不存在（确认note_id正确性）。
  - 429：频率超限（降低请求频率或申请提额）。
数据合规与安全
- 严格遵守《个人信息保护法》和小红书数据政策，禁止爬取用户隐私数据（如手机号、地址）。
- 数据仅限申请时声明的用途（如内容分析），禁止商业营销滥用。
- 敏感数据需脱敏处理，存储使用文档数据库（如MongoDB）或关系型数据库（如MySQL）。
替代方案（无API权限时）
- 第三方工具：如新红数据、蝉妈妈，提供付费/免费额度获取笔记互动数据。
- 网络抓包：通过Fiddler抓取小红书APP或网页的接口请求（需配置手机代理，分析api.xiaohongshu.com的评论接口），但存在合规风险。
- 官方数据合作：联系小红书商务团队申请定制化数据服务（需企业资质和预算）。