小红书数据 API | SocialDataX Xiaohongshu XHS RedNote

Pricing

Rating

Developer

Actor stats

Categories

Share

这是社媒数据助手 SocialDataX 的 Apify Actor 适配层，提供只读小红书 / Xiaohongshu / XHS / RedNote data API。

Apify 用户无需配置 SocialDataX API Key；直接通过 Apify Console、Apify API、Dataset export 或自动化工作流运行即可。

支持能力：

• 笔记搜索 / note search
• 搜索热榜 / search hot list
• 笔记详情 / note details
• 评论列表 / comments
• 评论回复 / comment replies
• 博主信息 / creator profiles
• 博主笔记列表 / creator notes

This Actor is a read-only, unofficial data API integration. It is not affiliated with Xiaohongshu, XHS, or RedNote.

Support / 联系我们

如果 run 失败、需要更高用量，或想接入批量数据工作流，请通过 SocialDataX support 联系我们：

• Website: https://socialdatax.52choujiang.com/

If a run fails, you need higher limits, or you want to discuss a bulk data workflow, contact SocialDataX support:

• Website: https://socialdatax.52choujiang.com/

选择字段

先选择 operation，再填写该 operation 需要的字段。Apify 表单里其它字段可以留空；即使误填了无关字段，Actor 也会忽略。

输入示例

笔记搜索：

{
"operation":"search_notes",
"keyword":"露营",
"page":1,
"sort_type":"general",
"note_type":"all",
"publish_time_range":"all",
"max_items":50,
"auto_paginate":true
}

搜索热榜：

{
"operation":"search_hot_list",
"max_items":50
}

笔记详情：

{
"operation":"get_note_detail",
"note_url":"https://www.xiaohongshu.com/explore/example"
}

评论列表：

{
"operation":"get_note_comments",
"note_url":"https://www.xiaohongshu.com/explore/example",
"page_token":"",
"max_items":50,
"auto_paginate":true
}

评论回复：

{
"operation":"get_note_sub_comments",
"note_id":"note_123",
"comment_id":"comment_123",
"page_token":"",
"max_items":50,
"auto_paginate":true
}

comment_id 来自 get_note_comments 的 Dataset 结果。选择 reply_count > 0 的一级评论行，复制该行的 comment_id。

max_items 默认 50，最大 500。auto_paginate=false 时只请求当前 page 或 page_token。搜索热榜不需要分页参数，Actor 会请求一次，并按 max_items 限制写入 Dataset 的热榜条目数。

如果用户在 Apify run options 里设置了更低的 paid Dataset item 上限，Actor 会把列表类 max_items 自动裁剪到该上限，避免超预算请求过多页面。 如果该上限为 0，Actor 会直接结束并在 OUTPUT 写入 warning，不会请求 SocialDataX API。

Apify 计划要求

持续使用需要 Apify paid plan。Apify free plan 用户有 5 次 SocialDataX API request 试用额度；每次请求一个接口页面计 1 次，auto_paginate=true 时每翻一页都会计入一次。试用额度用完后，请升级 Apify 计划继续使用。

Ongoing use requires an Apify paid plan. Free-plan users get a 5-request SocialDataX API trial. Each requested page counts as one request, so auto_paginate=true can consume multiple requests in one run.

输出

Actor 会把结果写入 Apify Dataset，适合 JSON、CSV、Excel / XLSX、JSONL 等格式导出。

列表类接口会为 items[] 中的每个元素写入一条扁平 dataset row：

{
"operation":"get_note_comments",
"item_index":1,
"query_note_id":"note_123",
"query_page_token":"",
"query_max_items":50,
"query_auto_paginate":true,
"comment_id":"comment_1",
"content":"想买",
"author_user_id":"user_1",
"author_name":"作者 A",
"page_request_index":1,
"page_item_count":20,
"page_next_page_token":"next-token",
"page_has_more":true
}

详情类接口会写入一条 dataset row。author、video 等常见对象会展开为 author_*、video_* 字段；图片、话题、数组字段保留 JSON 值。

如果某一页 items 为空但仍有分页信息，Actor 会写入一条 empty_page=true 的 summary row，避免丢失 next_page 或 next_page_token。如果空页已经没有下一页，则不会写入 Dataset row。

如果 run 失败，OUTPUT 会保留一条轻量失败摘要，方便在 Apify 控制台里直接看到请求次数、状态码和简要错误信息。

Apify API 调用

同步运行并直接获取 Dataset items：

curl-X POST "https://api.apify.com/v2/acts/socialdatax~socialdatax-xhs-data-api/run-sync-get-dataset-items?token=$APIFY_TOKEN"\
-H"Content-Type: application/json"\
-d'{
 "operation": "search_notes",
 "keyword": "露营",
 "max_items": 50,
 "auto_paginate": true
 }'

Python client 示例：

from apify_client import ApifyClient
client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("socialdatax/socialdatax-xhs-data-api").call(run_input={
"operation":"search_notes",
"keyword":"露营",
"max_items":50,
"auto_paginate":True,
})
items = client.dataset(run["defaultDatasetId"]).list_items().items

费用

Apify 用户按 Actor 页面展示的 Apify 价格和用量计费，不需要购买或配置 SocialDataX API Key。

Operator setup

这部分只给 Actor owner / 后端运维使用，Apify 用户不需要配置。

• 在 Apify Console 的 Actor environment variables 里设置 SOCIALDATAX_API_KEY，值使用专门给 Apify Actor 创建的 SocialDataX API Key，并标记为 Secret。
• 在 SocialDataX 后端运行环境里设置 SOCIALDATAX_APIFY_ACTOR_API_KEY，值必须与 Apify Actor 使用的专用 key 一致。后端只会在这把 key 匹配时识别官方 Actor 运行，用于区分 Apify free / paid 用户、免费试用额度和 Apify 专属调用审计。
• 不要把这两个 key 写入 .actor/actor.json、源码、README 示例、日志或截图。