小红书 · 操作教程
小红书 API 接入教程：搜索笔记与读取评论
需要将小红书数据接入自己的应用时，可以使用 Galaxy API 的 HTTP/JSON 接口。网页工作台适合日常采集，API 适合在自有程序中组织请求、保存结果并接入后续分析流程。
创建密钥并设置认证
注册账号并完成邮箱验证，在控制台的 API 密钥页面创建密钥。业务请求使用 https://api.galaxysapi.com，在 Authorization 请求头直接传入完整 API Key，不添加 Bearer 前缀。密钥应保存在服务端环境变量中。
发送一次笔记搜索请求
以下示例搜索“咖啡”，并读取第一页结果。先用少量请求确认返回字段，再按应用需求保存数据。接口参数和返回结构以在线 API 文档为准。
export GALAXY_API_KEY='YOUR_API_KEY'
curl --get 'https://api.galaxysapi.com/api/search_note_v1' \
--header "Authorization: $GALAXY_API_KEY" \
--data-urlencode 'keyword=咖啡' \
--data-urlencode 'page=1' \
--data-urlencode 'page_size=20' \
--connect-timeout 10 --max-time 60 --fail-with-body把搜索、详情和评论串起来
- 使用 /api/search_note_v1 获取搜索结果，保存笔记标识和来源信息。
- 需要进一步查看内容时，参考 /api/get_note_detail_v1 的参数要求查询笔记详情。
- 研究用户反馈时，使用 /api/get_note_comment_v1 读取评论；分页参数按该接口文档处理。
- 保存原始响应和采集时间，在本地整理、去重并导入自己的分析工具。
分页、错误与调用记录
不同接口可能使用页码或游标分页，不要假设所有接口都接受同一组参数。处理响应中的业务错误信息，并在无更多结果时停止分页。出现频率限制时降低并发、延迟后重试；认证和参数错误应先修正原因。
遇到调用异常时，在控制台查看调用记录，保留请求时间、接口名称和脱敏后的错误信息。不要将 API Key 写进公开仓库、浏览器页面或分享的日志。
常见问题
有 Python 或 Node.js 示例吗？
公开 GitHub 仓库提供可运行的 Python、Node.js 示例、参数说明和脱敏返回示例。它用于介绍平台与演示 API 接入。
API 与网页采集有什么区别？
网页工作台提供任务进度、预览和导出界面；API 提供程序调用能力，调用方需要根据接口组织分页、保存和后续处理。