小红书 — 首页推荐（Web V3）
SpiderHubs OpenAPI 文档：小红书 — 首页推荐（Web V3），分类 小红书。接口 GET /openapi/v1/contentcreator/xiaohongshu/web_v3/fetch_homefeed。Web V3 首页推荐笔记流，游标分页，单页最多 40 条。与 POST 版「...
OpId:
xhs-homefeed-web-v3 · 最近更新: 2026-05-23说明
Web V3 首页推荐笔记流，游标分页，单页最多 40 条。与 POST 版「首页推荐」是不同数据源。
基础信息
- Endpoint:
- GET /openapi/v1/contentcreator/xiaohongshu/web_v3/fetch_homefeed
- 计费:
- 1 积分 / 次
- 限流:
- 300 次 / 分钟 / 用户
请求参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| num | string | 否 | 返回数量，最大 40，默认 20 |
| cursor_score | string | 否 | 分页游标，首次留空 |
| category | string | 否 | 分类频道 ID，默认 homefeed_recommend |
| need_filter_image | string | 否 | 仅图文开关（true=仅图文，false=含视频的综合推荐） |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 业务状态码，200 表示成功 |
| request_id | string | 本次请求唯一标识，排查问题时可提供 |
| data | object | 业务数据容器，具体字段见下 |
| items | array | 推荐笔记卡片列表，每条含 note_id、title 标题、type 类型、cover 封面、user 作者、互动计数 |
| cursor_score / cursor | string | 翻页游标 |
| has_more | bool | 是否还有更多数据 |
请求示例 · cURL
curl 'https://api.spiderhubs.com/openapi/v1/contentcreator/xiaohongshu/web_v3/fetch_homefeed?num=20&cursor_score=&category=homefeed_recommend' \
-H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'响应示例
{
"code": 200,
"request_id": "...",
"data": { /* platform-native data — see endpoint reference for shape */ }
}开始调用 SpiderHubs API
使用账户中心生成的 API Key，通过 Authorization: Bearer sk_live_xxx 调用接口。