SocialDataX 小红书 Xiaohongshu XHS RedNote MCP
REMOTE · MCP.SOCIALDATAX.COM
XHS search/details, PGY, comments/replies, users/ID resolution/posts, transcript
Available components
Last scanned (9 hours ago)
Scores higher than 89% of remote servers
Reachable. Last reached 5 Nov 2026.
Category News and Social
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security71
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, but the challenge carries no valid RFC 9728 metadata, so a client cannot discover where to get a token. See how to fix → View diagnostics → Fail
- HTTPS enforcement could not be verified: the plaintext port answered with HTTP 404, which proves neither a plaintext path nor enforcement. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability80
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 7815 tokens (~195/item across 40 items; 38 tools + 2 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management94
- Stability check failed: schema churn in the 29 days we've observed: 1 tool removals, 0 breaking changes, 0 auth/transport breaks, 3 additions. See how to fix → Fail
Tool Coverage98
- 97% of tools have a non-trivial description (not blank, and not just the tool's name).Partial
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 38 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 40 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (12)
- TLS certificate
- Authorization
- HSTS header
- DNSSEC
- Transport
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (1)
These are gaps on our side, not findings about this hosted endpoint. We only credit what we can confirm, so a category made up entirely of them scores 0.
- HTTPS in Endpoint SecurityHTTPS enforcement could not be verified: the plaintext port answered with HTTP 404, which proves neither a plaintext path nor enforcement.
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 31 Oct 26 −1
- Stability: pass → fail ▼ security
- 24 Oct 26 0
- New tool “xhs_get_note_share_link_by_note_url” functional
- New tool “xhs_get_note_share_link_by_note_id” functional
- 20 Oct 26 0
- Tool “xhs_get_user_id_by_encrypted_user_id” rewrote its description, which is the text the model reads security
- New tool “xhs_get_share_info” functional
- “xhs_get_user_info_by_user_id” reworded the description of “user_id” cosmetic
- “xhs_get_user_posted_notes_by_user_id” reworded the description of “user_id” cosmetic
- “xhs_get_user_posted_notes_by_user_id” reworded the description of “page_token” cosmetic
- “xhs_get_user_posted_notes_by_profile_url” reworded the description of “page_token” cosmetic
- 14 Oct 26 0
- Tool “xhs_search_videos” was removed ▼ security
- Tool “xhs_search_notes” rewrote its description, which is the text the model reads security
- Tool “xhs_search_images” rewrote its description, which is the text the model reads security
- Server version: 0.1.14 → 0.1.15 functional
- 10 Oct 26 +1
- Stability: fail → pass ▲ security
- 1 Oct 26 0
- Tool “xhs_search_notes” rewrote its description, which is the text the model reads security
- New tool “xhs_search_videos” functional
- New tool “xhs_search_images” functional
- 29 Sept 26 0
- Tool “xhs_pgy_get_creator_notes_performance” rewrote its description, which is the text the model reads security
- Tool “xhs_pgy_get_creator_profile” rewrote its description, which is the text the model reads security
- Schema quality: 6304 → 7160 ▼ functional
- New tool “xhs_pgy_get_creator_commercial_overview” functional
- New tool “xhs_pgy_get_creator_metrics_trend” functional
- “xhs_pgy_get_creator_notes_performance” added an optional parameter “note_scope” cosmetic
- 28 Sept 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Probed https://mcp.socialdatax.com/xhs/mcp
TLS valid
Negotiated TLS 1.2 with TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=mcp.socialdatax.com | CN=TrustAsia DV TLS RSA CA 2024,O=TrustAsia Technologies\, Inc.,C=CN | 25 Sept 2026 | 24 Dec 2026 | RSA 2048 | SHA256-RSA | 75b0095b0f85e15a5e121c7ea4a0ec94f659cadc |
| SANs: mcp.socialdatax.com | ||||||
| CN=TrustAsia DV TLS RSA CA 2024,O=TrustAsia Technologies\, Inc.,C=CN (CA) | CN=TrustAsia TLS RSA Root CA,O=TrustAsia Technologies\, Inc.,C=CN | 15 May 2024 | 15 May 2034 | RSA 4096 | SHA384-RSA | 1c9e6b412deb0a85461de03dbe30984d0573888b |
| CN=TrustAsia TLS RSA Root CA,O=TrustAsia Technologies\, Inc.,C=CN (CA) | CN=Certum Trusted Network CA,OU=Certum Certification Authority,O=Unizeto Technologies S.A.,C=PL | 7 Oct 2025 | 14 Jan 2029 | RSA 4096 | SHA384-RSA | b2dc4c34932d709cd4bf0b099401695c |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of mcp.socialdatax.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | Trust anchor | 20326, 38696 | 8, 8 | Verified |
| com. | DS published | 19718 | 13 | Verified |
| socialdatax.com. | No DS | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Challenged, unverified
The endpoint asked for a token, but we could not retrieve and validate the RFC 9728 metadata that tells a client how to obtain one.
| Result | Challenged, unverified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 200 |
WWW-Authenticate challenge Bearer error="missing_api_key", error_description="API Key required"
Bearer error="missing_api_key", error_description="API Key required"Protected resource metadata
| Retrieved | No |
|---|---|
| Problem | No resource metadata |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://mcp.socialdatax.com/xhs/mcp | Verified | 200 | |
| http (plaintext) | http://mcp.socialdatax.com/xhs/mcp | Inconclusive | 404 |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
socialdatax_get_points_balance ~53
查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
xhs_get_note_comments_by_note_id ~267
根据 note_id 获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| page_token | – | – | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sort_type | string | – | 评论排序方式，可选：default（默认/综合排序）、time_descending（最新评论优先）、like_count_descending（点赞最多优先） |
| Name | Type | Req | Description |
|---|---|---|---|
| comment_count | integer | yes | 整篇笔记的总评论数，含一级评论与回复；不是当前页 items 数量 |
| items | array | yes | 当前页一级评论列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| top_level_comment_count | – | yes | 整篇笔记的一级评论总数，不含回复；不是当前页 items 数量；无法获取时为 null |
No examples provided.
xhs_get_note_comments_by_note_url ~272
根据笔记链接、短链接或分享文案获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| note_url | string | yes | 小红书笔记链接、短链接或分享文案。支持以下形式：1) 小红书笔记长链接；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。 |
| page_token | – | – | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sort_type | string | – | 评论排序方式，可选：default（默认/综合排序）、time_descending（最新评论优先）、like_count_descending（点赞最多优先） |
| Name | Type | Req | Description |
|---|---|---|---|
| comment_count | integer | yes | 整篇笔记的总评论数，含一级评论与回复；不是当前页 items 数量 |
| items | array | yes | 当前页一级评论列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| top_level_comment_count | – | yes | 整篇笔记的一级评论总数，不含回复；不是当前页 items 数量；无法获取时为 null |
No examples provided.
xhs_get_note_detail_by_note_id ~173
根据 note_id 获取单篇小红书笔记详情。 返回的 note_url 非 null 时，在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| Name | Type | Req | Description |
|---|---|---|---|
| author | object | yes | 作者信息；详情页不返回小红书号 |
| collect_count | integer | yes | 收藏数 |
| comment_count | integer | yes | 评论数 |
| content | string | yes | 笔记正文 |
| cover_image_url | string | yes | 统一封面图 |
| image_items | array | yes | 图片结构化明细；每项都表示一张图片，Live 图会在对应项携带 live_photo 摘要 |
| ip_location | string | yes | 笔记发布时的 IP 属地；没有 IP 属地时为空字符串 |
| like_count | integer | yes | 点赞数 |
| mentioned_users | array | yes | 笔记正文中 @ 到的用户列表；无 @ 时为空数组 |
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| note_type | string | yes | 笔记类型；当前公开值固定为 image 或 video |
| note_url | – | yes | note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。无法提供可用链接时为 null；note_url 为 null 时不要用 note_id 合成公开链接。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| publish_time | integer | yes | 发布时间，秒级 Unix 时间戳 |
| share_count | integer | yes | 分享数 |
| title | string | yes | 笔记标题 |
| topic_tags | array | yes | 笔记详情中的话题标签；无话题时为空数组 |
| update_time | – | yes | 更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null |
| video | – | yes | 视频摘要信息；无可用视频摘要时为 null |
No examples provided.
xhs_get_note_detail_by_note_url ~175
根据笔记链接、短链接或分享文案获取单篇小红书笔记详情。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。
| Name | Type | Req | Description |
|---|---|---|---|
| note_url | string | yes | 小红书笔记链接、短链接或分享文案。支持以下形式：1) 小红书笔记长链接；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。 |
| Name | Type | Req | Description |
|---|---|---|---|
| author | object | yes | 作者信息；详情页不返回小红书号 |
| collect_count | integer | yes | 收藏数 |
| comment_count | integer | yes | 评论数 |
| content | string | yes | 笔记正文 |
| cover_image_url | string | yes | 统一封面图 |
| image_items | array | yes | 图片结构化明细；每项都表示一张图片，Live 图会在对应项携带 live_photo 摘要 |
| ip_location | string | yes | 笔记发布时的 IP 属地；没有 IP 属地时为空字符串 |
| like_count | integer | yes | 点赞数 |
| mentioned_users | array | yes | 笔记正文中 @ 到的用户列表；无 @ 时为空数组 |
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| note_type | string | yes | 笔记类型；当前公开值固定为 image 或 video |
| note_url | – | yes | note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。无法提供可用链接时为 null；note_url 为 null 时不要用 note_id 合成公开链接。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| publish_time | integer | yes | 发布时间，秒级 Unix 时间戳 |
| share_count | integer | yes | 分享数 |
| title | string | yes | 笔记标题 |
| topic_tags | array | yes | 笔记详情中的话题标签；无话题时为空数组 |
| update_time | – | yes | 更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null |
| video | – | yes | 视频摘要信息；无可用视频摘要时为 null |
No examples provided.
xhs_get_note_share_link_by_note_id ~58
根据小红书笔记 ID 获取完整分享内容和分享短链接。已有笔记链接时使用按链接获取分享链接工具。
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | 小红书笔记 ID。 |
| Name | Type | Req | Description |
|---|---|---|---|
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| share_text | string | yes | 包含分享短链接的完整分享内容，可复制分享。 |
| short_url | string | yes | 小红书笔记分享短链接。 |
No examples provided.
xhs_get_note_share_link_by_note_url ~75
根据小红书笔记链接、短链接或分享文案获取完整分享内容和分享短链接。已有 note_id 时使用按 ID 获取分享链接工具。
| Name | Type | Req | Description |
|---|---|---|---|
| note_url | string | yes | 小红书笔记页面链接、短链接或包含链接的分享文案。 |
| Name | Type | Req | Description |
|---|---|---|---|
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| share_text | string | yes | 包含分享短链接的完整分享内容，可复制分享。 |
| short_url | string | yes | 小红书笔记分享短链接。 |
No examples provided.
xhs_get_note_sub_comments_by_comment_id ~312
根据 note_id 和一级评论 comment_id 获取二级评论；用户已提供完整合法的 ID 组合时直接使用；已有 note_id 或笔记链接但缺少必需 ID 时，调用对应一级评论工具补全；缺少笔记定位信息时向用户索取；支持 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| comment_id | string | yes | 一级评论 ID；用户已提供时直接使用，否则可从一级评论结果 items[].comment_id 复制；不要传二级评论项自身的 comment_id。 |
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| page_token | – | – | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一 note_id 和 comment_id 的二级评论列表，不能跨笔记或一级评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页二级评论列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一 note_id 和 comment_id 的二级评论列表，不能跨笔记或一级评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_get_product_detail_by_sku_id ~123
根据小红书商品 sku_id 获取商品详情；已有该 ID 时直接使用，否则可从 xhs_search_products 获取。只有商品链接、短链接或分享文案时使用 xhs_get_product_detail_by_url；本工具不支持商品链接、spu_id 或搜索词。
| Name | Type | Req | Description |
|---|---|---|---|
| sku_id | string | yes | 小红书商品 SKU ID。用户已提供时原样使用；否则从 xhs_search_products 的 items[*].sku_id 原样复制。不支持 spu_id、商品链接或搜索关键词。 |
| Name | Type | Req | Description |
|---|---|---|---|
| assurances | array | yes | 商品保障服务列表 |
| coupon_price | number | yes | 当前 SKU 展示的券后/成交价格，单位：元；不保证是最终实付价 |
| detail_images | array | yes | 商品详情图列表 |
| main_images | array | yes | 商品顶部主图/轮播图列表 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| price | number | yes | 当前 SKU 的商品原价，单位：元；不是商品搜索的展示销售价，也不是最终实付价 |
| product_score | – | – | 商品评分；不是店铺评分或好评率；无法确认时为 null |
| review_count | – | – | 商品评价总数；无法确认时为 null，不代表零评价 |
| sales_text | string | yes | 平台展示的商品销量文本；没有时为空字符串。带“+”的数量表示下限，不是精确销量；结合 sold_count 解读。 |
| selected_variant | string | yes | 当前选中规格；没有规格时为空字符串 |
| seller_id | – | – | 店铺关联小红书账号 UID；不是店铺 ID 或经营主体 ID；无法获取时为 null |
| shipping | object | yes | 发货信息 |
| shop_avatar_url | string | yes | 店铺头像链接 |
| shop_fans_text | string | yes | 店铺粉丝数展示值；没有粉丝信息时为空字符串 |
| shop_id | string | yes | 店铺 ID |
| shop_name | string | yes | 店铺名称 |
| shop_score | string | yes | 店铺评分展示值；没有评分时为空字符串 |
| shop_sold_text | string | yes | 店铺已售展示值；没有已售信息时为空字符串 |
| sku_id | string | yes | 商品 SKU ID |
| sold_count | – | yes | 已售数量；平台以带“+”的千级或万级文本展示时转换为对应整数下限（如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000），不是精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0。 |
| specifications | array | yes | 商品属性/规格参数列表（name/value），不是可选 SKU 规格组 |
| stock_status | integer | yes | 库存状态码；具体码值含义未公开定义，不要自行解释为是否在售或是否可购买 |
| title | string | yes | 商品标题 |
No examples provided.
xhs_get_product_detail_by_url ~104
根据小红书商品链接、短链接或分享文案获取商品详情，无需先搜索。已有完整 sku_id 时使用 xhs_get_product_detail_by_sku_id；返回的 sku_id 可继续用于商品评价工具。
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | 小红书商品详情链接、短链接或包含商品链接的完整分享文案。不支持笔记链接、博主主页链接、纯分享口令或搜索词。 |
| Name | Type | Req | Description |
|---|---|---|---|
| assurances | array | yes | 商品保障服务列表 |
| coupon_price | number | yes | 当前 SKU 展示的券后/成交价格，单位：元；不保证是最终实付价 |
| detail_images | array | yes | 商品详情图列表 |
| main_images | array | yes | 商品顶部主图/轮播图列表 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| price | number | yes | 当前 SKU 的商品原价，单位：元；不是商品搜索的展示销售价，也不是最终实付价 |
| product_score | – | – | 商品评分；不是店铺评分或好评率；无法确认时为 null |
| review_count | – | – | 商品评价总数；无法确认时为 null，不代表零评价 |
| sales_text | string | yes | 平台展示的商品销量文本；没有时为空字符串。带“+”的数量表示下限，不是精确销量；结合 sold_count 解读。 |
| selected_variant | string | yes | 当前选中规格；没有规格时为空字符串 |
| seller_id | – | – | 店铺关联小红书账号 UID；不是店铺 ID 或经营主体 ID；无法获取时为 null |
| shipping | object | yes | 发货信息 |
| shop_avatar_url | string | yes | 店铺头像链接 |
| shop_fans_text | string | yes | 店铺粉丝数展示值；没有粉丝信息时为空字符串 |
| shop_id | string | yes | 店铺 ID |
| shop_name | string | yes | 店铺名称 |
| shop_score | string | yes | 店铺评分展示值；没有评分时为空字符串 |
| shop_sold_text | string | yes | 店铺已售展示值；没有已售信息时为空字符串 |
| sku_id | string | yes | 商品 SKU ID |
| sold_count | – | yes | 已售数量；平台以带“+”的千级或万级文本展示时转换为对应整数下限（如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000），不是精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0。 |
| specifications | array | yes | 商品属性/规格参数列表（name/value），不是可选 SKU 规格组 |
| stock_status | integer | yes | 库存状态码；具体码值含义未公开定义，不要自行解释为是否在售或是否可购买 |
| title | string | yes | 商品标题 |
No examples provided.
xhs_get_product_review_replies ~193
根据一级商品评价 review_id 获取其下回复；已有该 ID 时直接使用，否则可从 xhs_get_product_reviews 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | string | – | 商品评价回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一一级评价和调用方，不能跨链路复用。 |
| review_id | string | yes | 一级商品评价 ID。用户已提供时原样使用；否则从 xhs_get_product_reviews 的 items[*].review_id 原样复制。不要传 root_review_id。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页商品评价回复列表 |
| next_page_token | string | yes | 下一页不透明商品评价回复分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须原样传回，只能用于同一一级评价和调用方。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_get_product_review_reply_replies ~206
根据商品评价回复 review_id 获取其下的嵌套回复；已有该 ID 时直接使用，否则可从 xhs_get_product_review_replies 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | string | – | 商品评价回复的回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一父级回复和调用方，不能跨链路复用。 |
| review_id | string | yes | 商品评价回复 ID。用户已提供时原样使用；否则从 xhs_get_product_review_replies 的 items[*].review_id 原样复制。不要传 root_review_id。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页商品评价回复的回复列表 |
| next_page_token | string | yes | 下一页不透明商品评价回复的回复分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须原样传回，只能用于同一父级回复和调用方。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_get_product_reviews ~300
根据小红书商品 sku_id 获取商品评价；已有该 ID 时直接使用，否则可从 xhs_search_products 获取；支持 sort_type、has_image 和 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不支持商品链接、spu_id 或搜索词。
| Name | Type | Req | Description |
|---|---|---|---|
| has_image | boolean | – | 是否只返回带图片的商品评价 |
| page_token | string | – | 商品评价分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一商品 SKU、排序、图片筛选和调用方的商品评价链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sku_id | string | yes | 小红书商品 SKU ID。用户已提供时原样使用；否则从 xhs_search_products 的 items[*].sku_id 原样复制。不支持 spu_id、商品链接或搜索关键词。 |
| sort_type | string | – | 商品评价排序方式，可选：general（综合，默认）、time_descending（最新评价优先） |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页商品评价列表 |
| next_page_token | string | yes | 下一页不透明商品评价分页令牌；items 为空时仍应继续翻页；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一商品 SKU、排序、图片筛选和调用方的商品评价链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_get_search_hot_list ~20
获取小红书搜索热榜。
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 搜索热榜条目列表 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_get_share_info ~81
根据小红书笔记分享短链接或完整分享文案获取分享人、笔记摘要及作者。 需要笔记完整内容时，使用笔记详情工具；分享信息不包含分享时间。
| Name | Type | Req | Description |
|---|---|---|---|
| share_text | string | yes | 小红书笔记分享短链接，或包含该链接的完整分享文案。 |
| Name | Type | Req | Description |
|---|---|---|---|
| note_info | – | yes | 该链接的笔记摘要及作者；缺失时为 null |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| share_user_info | – | yes | 该链接的分享人；缺失时为 null |
No examples provided.
xhs_get_topic_notes_by_page_id ~185
根据 page_id 获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| page_id | string | yes | 小红书标签页 page_id。 |
| page_token | string | – | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sort_type | string | – | 标签页笔记排序方式，可选：hot（最热，默认）、time_descending（最新） |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 标签页笔记列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；非空表示可尝试请求下一页，为空表示当前没有可继续的下一页令牌。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；items 为空时不要单独据此判断结束；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换… |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| total_note_count | integer | yes | 标签页笔记总数 |
| total_user_count | integer | yes | 标签页涉及用户总数 |
No examples provided.
xhs_get_topic_notes_by_topic_url ~264
根据话题页链接、短链接或分享文案获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | string | – | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sort_type | string | – | 标签页笔记排序方式，可选：hot（最热，默认）、time_descending（最新） |
| topic_url | string | yes | 小红书话题页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/topic/normal/... 话题页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 标签页笔记列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；非空表示可尝试请求下一页，为空表示当前没有可继续的下一页令牌。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；items 为空时不要单独据此判断结束；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换… |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| total_note_count | integer | yes | 标签页笔记总数 |
| total_user_count | integer | yes | 标签页涉及用户总数 |
No examples provided.
xhs_get_user_id_by_encrypted_user_id ~114
根据完整加密用户 ID 获取稳定 user_id。 仅需单独转换 ID 时使用；查询用户信息或作品可直接使用已有用户 ID 或主页链接，无需先调用本工具。
| Name | Type | Req | Description |
|---|---|---|---|
| encrypted_user_id | string | yes | 小红书加密用户 ID。用户已提供时直接原样使用；请传入完整 29 位小写十六进制值；不要传 24 位 user_id、小红书号、昵称或主页链接 |
| Name | Type | Req | Description |
|---|---|---|---|
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| user_id | string | yes | 稳定用户 user_id |
No examples provided.
xhs_get_user_info_by_profile_url ~124
根据主页链接、短链接或分享文案获取单个小红书用户信息。
| Name | Type | Req | Description |
|---|---|---|---|
| profile_url | string | yes | 小红书主页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/user/profile/... 主页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。请传主页链接，不要传笔记链接。 |
| Name | Type | Req | Description |
|---|---|---|---|
| avatar_url | – | yes | 用户头像链接；没有头像链接时为 null |
| bio | string | yes | 用户个人简介（biography）；没有简介时为空字符串 |
| follower_count | integer | yes | 粉丝数 |
| following_count | integer | yes | 关注数 |
| ip_location | string | yes | 用户 IP 属地；没有 IP 属地时为空字符串 |
| is_enterprise_account | boolean | yes | 是否为企业账号 |
| is_professional_account | boolean | yes | 是否为专业号 |
| name | string | yes | 用户名称 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| posted_note_count | integer | yes | 已发布笔记数 |
| profile_tags | array | yes | 主页头部标签名称列表；没有标签时为空数组 |
| profile_url | – | yes | 用户主页链接；没有主页链接时为 null |
| received_collect_count | integer | yes | 用户内容累计被收藏数 |
| received_like_count | integer | yes | 用户内容累计收到的点赞数 |
| red_id | string | yes | 用户公开小红书号；没有小红书号时为空字符串 |
| user_id | string | yes | 用户 user_id |
| verification_category | string | yes | 认证补充信息；可能是行业类目或认证主体名称；未认证或没有认证信息时为空字符串 |
| verification_name | string | yes | 认证主体名称；没有认证主体时为空字符串 |
| verified | boolean | yes | 是否已认证 |
No examples provided.
xhs_get_user_info_by_user_id ~135
根据 user_id 获取单个小红书用户信息。
| Name | Type | Req | Description |
|---|---|---|---|
| user_id | string | yes | 小红书用户 user_id。用户已提供时原样使用，支持完整的 24 位或 29 位小写十六进制 ID，无需先转换；否则可从笔记搜索、商品评价、商品评价回复、笔记详情、标签页笔记列表、用户信息或用户发帖列表结果中的 user_id/author.user_id 复制；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称。 |
| Name | Type | Req | Description |
|---|---|---|---|
| avatar_url | – | yes | 用户头像链接；没有头像链接时为 null |
| bio | string | yes | 用户个人简介（biography）；没有简介时为空字符串 |
| follower_count | integer | yes | 粉丝数 |
| following_count | integer | yes | 关注数 |
| ip_location | string | yes | 用户 IP 属地；没有 IP 属地时为空字符串 |
| is_enterprise_account | boolean | yes | 是否为企业账号 |
| is_professional_account | boolean | yes | 是否为专业号 |
| name | string | yes | 用户名称 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| posted_note_count | integer | yes | 已发布笔记数 |
| profile_tags | array | yes | 主页头部标签名称列表；没有标签时为空数组 |
| profile_url | – | yes | 用户主页链接；没有主页链接时为 null |
| received_collect_count | integer | yes | 用户内容累计被收藏数 |
| received_like_count | integer | yes | 用户内容累计收到的点赞数 |
| red_id | string | yes | 用户公开小红书号；没有小红书号时为空字符串 |
| user_id | string | yes | 用户 user_id |
| verification_category | string | yes | 认证补充信息；可能是行业类目或认证主体名称；未认证或没有认证信息时为空字符串 |
| verification_name | string | yes | 认证主体名称；没有认证主体时为空字符串 |
| verified | boolean | yes | 是否已认证 |
No examples provided.
xhs_get_user_posted_notes_by_profile_url ~262
根据主页链接、短链接或分享文案获取用户已发布笔记列表，支持 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | – | – | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一用户的发帖列表，不能跨用户复用；续页须保持首屏的输入用户 ID 不变，即使对应同一用户，也不能换成结果返回的另一种 ID；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| profile_url | string | yes | 小红书主页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/user/profile/... 主页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。请传主页链接，不要传笔记链接。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页用户发帖摘要列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_get_user_posted_notes_by_user_id ~273
根据 user_id 获取用户已发布笔记列表，支持 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | – | – | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一用户的发帖列表，不能跨用户复用；续页须保持首屏的输入用户 ID 不变，即使对应同一用户，也不能换成结果返回的另一种 ID；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| user_id | string | yes | 小红书用户 user_id。用户已提供时原样使用，支持完整的 24 位或 29 位小写十六进制 ID，无需先转换；否则可从笔记搜索、商品评价、商品评价回复、笔记详情、标签页笔记列表、用户信息或用户发帖列表结果中的 user_id/author.user_id 复制；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页用户发帖摘要列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_get_video_speech_text_job ~95
根据用户提供的有效 job_id，或提交工具返回的 job_id 查询任务状态；用于继续未完成任务，每次最多等待 240 秒，不触发重处理，也不要重复提交任务。
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | 口播转文字任务 ID；用户已提供时直接使用，否则使用提交工具返回的 job_id；不要传 note_id 或笔记链接。 |
| Name | Type | Req | Description |
|---|---|---|---|
| content_id | string | yes | 平台内容 ID。 |
| content_meta | object | yes | 作品上下文信息，便于结合转写内容做口播分析。 |
| content_type | string | yes | 内容类型。 |
| error | – | yes | 失败或过期时的稳定错误结构；非终态或成功时为 null。 |
| is_terminal | boolean | yes | 是否已终态。 |
| job_id | string | yes | 任务 ID。 |
| message | string | yes | 面向用户/AI 的状态说明。 |
| next_action | – | yes | 非终态时建议的下一步查询动作。 |
| next_poll_after_seconds | – | yes | 建议下次查询前等待的秒数；非终态时可用。 |
| platform | string | yes | 任务所属平台。 |
| source_id | string | yes | 任务来源 ID。 |
| status | string | yes | 任务状态。 |
| transcript | – | yes | 成功时的口播转文字结果；非终态或失败时为 null。 |
No examples provided.
xhs_pgy_get_creator_commercial_overview ~398
根据完整 user_id 获取小红书蒲公英创作者商业概览：笔记规模和中位数、服务表现、平台标签、增长、预估成本及对比值。 查询指定日常/合作口径的商业汇总与成本参考时使用，不返回逐篇明细。逐篇表现使用创作者笔记表现工具，也可选择日常或合作口径。资料与报价使用创作者档案工具，粉丝构成使用粉丝画像工具。 查看日常内容表现选 daily（默认，不是按天汇总）；查看商单、品牌合作笔记或外溢进店的汇总表现选 cooperation。输出回显口径，不能混用；不是对全部字段统一筛选，note_count 不能解释为所选口径的笔记数。两种口径的成本估计依据不同，均不代表实际成交成本或ROI。 不支持指定日期，统计截止日期未提供；进店不等于订单或成交，不据此推断调用方自己的投放成绩。 成功直接返回业务字段和 points；成功调用扣减 20 积分，失败不扣费。
| Name | Type | Req | Description |
|---|---|---|---|
| note_scope | string | – | 笔记统计口径：查看日常内容表现选 daily（默认），不是按天汇总；查看商单、品牌合作笔记或外溢进店表现选 cooperation；输出回显实际口径，不能混用；不表示所有字段均按此口径拆分，note_count 等字段按各自说明解读 |
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
| Name | Type | Req | Description |
|---|---|---|---|
| active_days_7d | – | yes | 平台 7 天统计窗口内登录小红书 App 的天数；截止日期未提供，不按查询日期或 data_date 推算起止日期，不等同发布笔记天数；未知时为 null |
| commercial_label | – | yes | 平台给出的商业标签原文，仅作平台评价展示，不作为独立评价结论；未知时为 null |
| commercial_label_description | – | yes | 平台商业标签说明原文；涉及排名或比较的文字仅代表平台说法，不提取为独立排名或百分位数值；未知时为 null |
| content_tags | – | yes | 平台 30 天窗口发布笔记的 TOP2 内容类目及笔记数量占比；不代表完整分布，不归一化或补其他，不保证与笔记表现接口同口径；未知时为 null，明确为空时为 [] |
| data_date | – | yes | 平台标注的数据日期（YYYY-MM-DD）；不代表查询时间或各指标统计截止日期；未知时为 null |
| estimated_picture_cpm | – | yes | 平台预估图文 CPM，单位人民币元/千次曝光；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null |
| estimated_picture_cpm_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文 CPM，不是实际成本或 ROI；相应预估成本不可用时为 null |
| estimated_picture_interaction_cost | – | yes | 平台预估图文互动单价，单位人民币元/次互动；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null |
| estimated_picture_interaction_cost_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文互动单价，不是实际成本或 ROI；相应预估成本不可用时为 null |
| estimated_picture_read_cost | – | yes | 平台预估图文阅读单价，单位人民币元/次阅读；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null |
| estimated_picture_read_cost_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文阅读单价，不是实际成本或 ROI；相应预估成本不可用时为 null |
| estimated_picture_store_visit_cost | – | yes | 平台预估图文外溢进店单价，人民币元/进店；依据近30天跨域合作笔记价格及进店UV估计，不是成交成本或ROI；daily、不可预估、零值或未知时为 null |
| estimated_picture_store_visit_cost_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文进店单价，不是实际成本或ROI；daily 或对应成本不可用时为 null |
| estimated_video_cpm | – | yes | 平台预估视频 CPM，单位人民币元/千次曝光；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null |
| estimated_video_cpm_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频 CPM，不是实际成本或 ROI；相应预估成本不可用时为 null |
| estimated_video_interaction_cost | – | yes | 平台预估视频互动单价，单位人民币元/次互动；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null |
| estimated_video_interaction_cost_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频互动单价，不是实际成本或 ROI；相应预估成本不可用时为 null |
| estimated_video_read_cost | – | yes | 平台预估视频阅读单价，单位人民币元/次阅读；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null |
| estimated_video_read_cost_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频阅读单价，不是实际成本或 ROI；相应预估成本不可用时为 null |
| estimated_video_store_visit_cost | – | yes | 平台预估视频外溢进店单价，人民币元/进店；依据近30天跨域合作笔记价格及进店UV估计，不是成交成本或ROI；daily、不可预估、零值或未知时为 null |
| estimated_video_store_visit_cost_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频进店单价，不是实际成本或ROI；daily 或对应成本不可用时为 null |
| follower_growth_benchmark_rate_30d | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天粉丝增长指标，窗口截止日期未提供；不是实际粉丝增长率 |
| follower_growth_rate_30d | – | yes | 平台 30 天统计窗口的粉丝增长率，0.1 表示 10%；不是构成占比，不限于 0–1。截止日期和计算基数未提供，不按查询日期或 data_date 推算窗口，不与其他周期增长率混用；未知时为 null |
| impression_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记曝光中位数，不保证与笔记表现接口同口径 |
| impression_median | – | yes | 平台 30 天窗口内所选口径笔记的曝光量中位数，不是累计曝光量；截止日期未提供，不用其他接口明细复算；未知时为 null |
| industry_labels | – | yes | 平台 30 天窗口内 TOP2 合作品牌行业；原样保留，不代表全部行业或具体品牌合作清单，不保证与创作者档案同口径；未知时为 null，明确为空时为 [] |
| interaction_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记中位数，不保证与笔记表现接口同口径 |
| interaction_median | – | yes | 平台 30 天窗口内所选口径笔记的互动量中位数，不是累计互动量；截止日期未提供，互动构成按平台口径，不用其他接口明细复算；未知时为 null |
| invitation_count | – | yes | 平台返回的邀约数量；统计周期、邀约方向及状态范围未明确，不等于成交或成功合作数量；未知时为 null |
| note_count | – | yes | 平台 30 天窗口内发布笔记数；不能因 note_scope=daily/cooperation 就解释为日常/合作笔记数量，不作为所选口径中位数的样本数量；不代表全部历史，截止日期未提供；未知时为 null |
| note_scope | string | yes | 笔记统计口径：查看日常内容表现选 daily（默认），不是按天汇总；查看商单、品牌合作笔记或外溢进店表现选 cooperation；输出回显实际口径，不能混用；不表示所有字段均按此口径拆分，note_count 等字段按各自说明解读 |
| outbound_store_visit_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应合作笔记外溢进店中位数；daily 时为 null |
| outbound_store_visit_median | – | yes | 平台30天合作笔记范围内的外溢进店量中位数；不是累计人数、订单数或成交额，窗口截止日未明确；daily 或未知时为 null |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| read_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记中位数，不保证与笔记表现接口同口径 |
| read_median | – | yes | 平台 30 天窗口内所选口径笔记的阅读量中位数，不是累计阅读量；截止日期未提供，不用其他接口明细复算；未知时为 null |
| response_rate | – | yes | 历史邀约合作消息在 48 小时内回复的比例，0.852 表示 85.2%；48 小时是回复时限，不是统计周期；累计周期和完整分母未提供，不用邀约数推算回复次数；邀约数不足 3 时不用于评价回复表现，不视为合作接受率；未知时为 null |
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
No examples provided.
xhs_pgy_get_creator_fans_profile ~195
根据完整 user_id 获取小红书蒲公英创作者粉丝画像，包括年龄、性别、地域、城市、兴趣和设备品牌分布及数据日期。 查询粉丝构成时使用；粉丝规模、增长、活跃、阅读和互动情况使用创作者粉丝汇总工具；创作者资料和报价使用创作者档案工具。 使用平台默认统计范围，不支持指定日期；分布不保证完整，不能据此推算粉丝人数或补齐其他类别。 成功返回画像字段和 points；成功调用扣减 20 积分，失败不扣费。
| Name | Type | Req | Description |
|---|---|---|---|
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
| Name | Type | Req | Description |
|---|---|---|---|
| age_distribution | – | yes | 粉丝年龄分布；保留平台年龄区间标签，不推断端点含义；不保证完整，未知时为 null，明确为空时为 [] |
| city_distribution | – | yes | 平台返回的粉丝城市分布；不保证列出全部城市，不重新归一化或补其他；未知时为 null，明确为空时为 [] |
| data_date | – | yes | 平台标注的数据日期（YYYY-MM-DD），不代表查询时间或统计起止范围；未知时为 null |
| device_distribution | – | yes | 粉丝设备品牌分布；不保证列出全部品牌，不重新归一化或补其他；未知时为 null，明确为空时为 [] |
| gender_distribution | – | yes | 粉丝性别分布；不推算缺失占比，未知时为 null |
| interest_distribution | – | yes | 粉丝兴趣分布；不保证分类完整或互斥，不用占比之和推算其他兴趣；未知时为 null，明确为空时为 [] |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| region_distribution | – | yes | 粉丝地域分布；标签可包含省份、中国、海外等，不统一视为省份；不保证完整，未知时为 null，明确为空时为 [] |
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
No examples provided.
xhs_pgy_get_creator_fans_summary ~187
根据完整 user_id 获取小红书蒲公英创作者粉丝总数、平台增长指标、活跃、阅读和互动粉丝人数及占比。 查询粉丝规模和活跃情况时使用；年龄、性别、地域和兴趣等构成使用创作者粉丝画像工具。 不支持指定日期或统计周期；增长周期及各统计窗口截止日期未提供，不能按查询日期推算，不承诺指定期间增长数据。 成功直接返回汇总字段和 points；成功调用扣减 20 积分，失败不扣费。
| Name | Type | Req | Description |
|---|---|---|---|
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
| Name | Type | Req | Description |
|---|---|---|---|
| active_follower_count_28d | – | yes | 平台 28 天统计窗口内的活跃粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；活跃判定按平台口径，不等同阅读或互动人数；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null |
| active_follower_ratio | – | yes | 平台返回的活跃粉丝占比，0.419 表示 41.9%；保留平台精度，分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null |
| engaged_follower_count_30d | – | yes | 平台 30 天统计窗口内的互动粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；不是互动次数，具体互动构成按平台口径；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null |
| engaged_follower_ratio | – | yes | 平台返回的互动粉丝占比，0.1 表示 10%；保留平台精度，0 不表示互动人数一定为 0；分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null |
| follower_count | – | yes | 蒲公英口径粉丝总数，单位人；未知时为 null |
| follower_growth_count | – | yes | 平台返回的粉丝增长数量；统计周期及是否扣除流失未明确，不可直接解释为近 30 天新增关注人数或净增人数；未知时为 null |
| follower_growth_rate | – | yes | 平台返回的粉丝增长率，0.1 表示 10%；不是粉丝构成占比，不限于 0–1。统计周期和计算基数未明确，不用返回人数复算；未知时为 null |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| read_follower_count_30d | – | yes | 平台 30 天统计窗口内的阅读粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；不是阅读次数；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null |
| read_follower_ratio | – | yes | 平台返回的阅读粉丝占比，0.001 表示 0.1%；保留平台精度，分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null |
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
No examples provided.
xhs_pgy_get_creator_metrics_trend ~318
根据完整 user_id 获取小红书蒲公英创作者曝光、阅读、互动中位数及预估成本的日期趋势和概览。 观察指标随时间变化时使用；中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，不支持自选日期。合作口径包含进店指标，日常口径的进店字段为 null；输出回显口径，不能混用。 返回指标不是每日新增量或累计总量，不可跨日期求和；可能缺少日期，不补零。 成本估算口径见字段说明，不代表实际成交成本；按图文/视频拆分的成本及商业汇总使用商业概览工具，逐篇表现使用笔记表现工具。 成功直接返回业务字段和 points；成功调用扣减 20 积分，失败不扣费。
| Name | Type | Req | Description |
|---|---|---|---|
| note_scope | string | – | 笔记统计口径：日常笔记趋势选 daily（默认，不是按天汇总）；合作笔记或进店趋势选 cooperation。输出回显口径，不可混用；成本估算依据见各字段说明 |
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | – | yes | 平台返回的日期序列；中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，成本口径见各字段说明；可能缺少日期，不补零、不插值；未知时为 null，明确为空时为 [] |
| note_scope | string | yes | 笔记统计口径：日常笔记趋势选 daily（默认，不是按天汇总）；合作笔记或进店趋势选 cooperation。输出回显口径，不可混用；成本估算依据见各字段说明 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| summary | – | yes | 平台提供的概览指标及其日期，不是趋势各点之和；缺失时为 null |
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
No examples provided.
xhs_pgy_get_creator_notes_performance ~395
根据完整 user_id 获取小红书蒲公英创作者笔记表现，包括笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和笔记明细。 查询日常或合作笔记表现及最近明细时使用；商业汇总与成本参考使用商业概览工具，资料和报价使用创作者档案工具。 视频完播相关字段仅在 video_note_count 大于 0 时用于表现判断；图文 3 秒阅读率仅在统计范围内有图文笔记时用于表现判断；其他情况下 0 值不表示对应表现为 0%。 固定近30日、图文＋视频、全流量，不支持自选日期或笔记类型；明细最多 15 篇，不是全量列表。仅 notes[] 内的 *_benchmark_rate 是相较于平台中位数的相对差异，允许负数和超过 1，不能当作排名比例；汇总层同名字段仍是平台返回的 0 到 1 对比值，计算方式未公开，不能混用。 成功返回表现字段和 points；成功调用扣减 20 积分，失败不扣费。
| Name | Type | Req | Description |
|---|---|---|---|
| note_scope | string | – | 笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径 |
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
| Name | Type | Req | Description |
|---|---|---|---|
| collect_median | – | yes | 笔记收藏量中位数；未知时为 null |
| comment_median | – | yes | 笔记评论量中位数；未知时为 null |
| content_tags | – | yes | 笔记内容标签分布；返回标签不保证覆盖全部内容，占比之和不保证为 1；不要自行归一化或补齐其他类别；未知时为 null，明确为空时为 [] |
| hundred_like_ratio | – | yes | 获赞不少于 100 的笔记占比，0.1 表示 10%；未知时为 null |
| image_3s_view_rate | – | yes | 图文笔记 3 秒阅读率，0.195 表示 19.5%；仅在统计范围内有图文笔记时用于表现判断；否则 0 值不表示 3 秒阅读率为 0%；未知时为 null |
| impression_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null |
| impression_median | – | yes | 笔记曝光量中位数；未知时为 null |
| interaction_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null |
| interaction_median | – | yes | 平台汇总口径的笔记互动量中位数；不保证与 notes[].interaction_count 的统计口径一致，不可直接用返回的笔记明细复算；未知时为 null |
| interaction_rate | – | yes | 平台返回的笔记互动率，0.195 表示 19.5%；本响应未提供可确认的计算分母和完整统计口径，不可用返回计数自行复算；未知时为 null |
| like_median | – | yes | 笔记点赞量中位数；未知时为 null |
| note_count | – | yes | 统计范围内笔记数；未知时为 null |
| note_scope | string | yes | 笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径 |
| notes | – | yes | 统计范围内最近发布的最多 15 篇笔记表现明细，不是全量列表；未知时为 null，明确为空时为 [] |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| read_benchmark_rate | – | yes | 平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null |
| read_median | – | yes | 笔记阅读量中位数；未知时为 null |
| share_median | – | yes | 笔记分享量中位数；未知时为 null |
| thousand_like_ratio | – | yes | 获赞不少于 1000 的笔记占比，0.1 表示 10%；未知时为 null |
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
| video_full_view_benchmark_rate | – | yes | 平台返回的视频完播指标对比值，范围 0~1；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示表现为 0；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null |
| video_full_view_rate | – | yes | 视频完播率，0.195 表示 19.5%；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示完播率为 0%；未知时为 null |
| video_note_count | – | yes | 统计范围内视频笔记数；未知时为 null |
No examples provided.
xhs_pgy_get_creator_profile ~208
根据完整 user_id 获取小红书蒲公英创作者档案、粉丝和商业笔记规模、合作行业、笔记阅读与互动中位数、内容分类、特征标签和创作者图文/视频合作报价。 查询蒲公英创作者资料和报价时使用；普通账号资料使用用户信息工具。 笔记表现使用创作者笔记表现工具；粉丝画像使用创作者粉丝画像工具；指标随日期变化使用创作者指标趋势工具。图文和视频报价单位为人民币元；零值不表示免费合作。 成功返回档案字段和 points；成功调用扣减 20 积分，失败不扣费。
| Name | Type | Req | Description |
|---|---|---|---|
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
| Name | Type | Req | Description |
|---|---|---|---|
| avatar_url | – | yes | 头像地址；缺失时为 null |
| business_note_count | – | yes | 商业笔记数；未知时为 null |
| content_categories | – | yes | 内容分类；未知时为 null，明确为空时为 [] |
| cooperation_industries | – | yes | 合作行业名称列表；未知时为 null，明确为空时为 [] |
| cooperation_note_count_30d | – | yes | 近 30 天合作笔记数；未知时为 null |
| feature_tags | – | yes | 创作者特征标签；不是主页标签；未知时为 null，明确为空时为 [] |
| follower_count | – | yes | 蒲公英口径粉丝数，单位人；未知时为 null |
| gender | – | yes | 创作者性别：male 表示男，female 表示女；无法确认时为 null |
| location | – | yes | 创作者资料所在地，不是 IP 属地；缺失时为 null |
| name | – | yes | 创作者昵称；上游未提供时为 null |
| note_interaction_median | – | yes | 蒲公英口径笔记互动数中位数；具体互动构成以上游口径为准；未知时为 null |
| note_read_median | – | yes | 蒲公英口径笔记阅读数中位数；未知时为 null |
| picture_price | – | yes | 创作者图文笔记合作报价，单位：人民币元；未知时为 null，零值不表示免费合作 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| profile_url | string | yes | 由 user_id 生成的用户主页地址 |
| received_like_and_collect_count | – | yes | 获赞与收藏合计；不能拆算为独立点赞数或收藏数；未知时为 null |
| red_id | string | yes | 公开小红书号；缺失时为空字符串，不能作为 user_id 使用 |
| user_id | string | yes | 小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。 |
| video_price | – | yes | 创作者视频笔记合作报价，单位：人民币元；未知时为 null，零值不表示免费合作 |
No examples provided.
xhs_pgy_get_note_detail_by_note_id ~329
根据 note_id 获取小红书蒲公英单篇笔记商业增强详情，包括正文、图片或视频摘要、作者、曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。 仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。 这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。 查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| Name | Type | Req | Description |
|---|---|---|---|
| author | object | yes | 作者信息；详情页不返回小红书号 |
| collect_count | integer | yes | 收藏数 |
| comment_count | integer | yes | 评论数 |
| content | string | yes | 笔记正文 |
| cover_image_url | string | yes | 统一封面图 |
| exposure_count | integer | yes | 笔记曝光量 |
| image_items | array | yes | 静态图片明细；不包含 Live 图视频摘要，需要 Live 视频时使用普通笔记详情接口 |
| like_count | integer | yes | 点赞数 |
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| note_type | string | yes | 笔记类型；当前公开值固定为 image 或 video |
| note_url | string | yes | note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。 |
| picture_price | number | yes | 创作者图文笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| publish_time | integer | yes | 发布时间，秒级 Unix 时间戳 |
| read_count | integer | yes | 笔记阅读量 |
| share_count | integer | yes | 分享数 |
| title | string | yes | 蒲公英笔记标题 |
| update_time | integer | yes | 更新时间，秒级 Unix 时间戳 |
| video | – | yes | 视频摘要信息；视频笔记返回对象，图文笔记为 null |
| video_price | number | yes | 创作者视频笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作 |
No examples provided.
xhs_pgy_get_note_detail_by_note_url ~313
根据笔记链接、短链接或分享文案获取小红书蒲公英单篇笔记商业增强详情，包括曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。 仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。 这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。 查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。
| Name | Type | Req | Description |
|---|---|---|---|
| note_url | string | yes | 小红书笔记链接、短链接或分享文案。支持小红书笔记长链接、xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接，以及包含上述链接的完整分享文案。 |
| Name | Type | Req | Description |
|---|---|---|---|
| author | object | yes | 作者信息；详情页不返回小红书号 |
| collect_count | integer | yes | 收藏数 |
| comment_count | integer | yes | 评论数 |
| content | string | yes | 笔记正文 |
| cover_image_url | string | yes | 统一封面图 |
| exposure_count | integer | yes | 笔记曝光量 |
| image_items | array | yes | 静态图片明细；不包含 Live 图视频摘要，需要 Live 视频时使用普通笔记详情接口 |
| like_count | integer | yes | 点赞数 |
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| note_type | string | yes | 笔记类型；当前公开值固定为 image 或 video |
| note_url | string | yes | note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。 |
| picture_price | number | yes | 创作者图文笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
| publish_time | integer | yes | 发布时间，秒级 Unix 时间戳 |
| read_count | integer | yes | 笔记阅读量 |
| share_count | integer | yes | 分享数 |
| title | string | yes | 蒲公英笔记标题 |
| update_time | integer | yes | 更新时间，秒级 Unix 时间戳 |
| video | – | yes | 视频摘要信息；视频笔记返回对象，图文笔记为 null |
| video_price | number | yes | 创作者视频笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作 |
No examples provided.
xhs_search_images ~246
按搜索词搜索小红书图片；已有笔记链接或 note_id，且需要读取该篇笔记详情时，使用对应详情工具。每项为一张图片及关联笔记，同一笔记可返回多张图片；page_token 可用于尝试下一页，不保证下一页有结果；结果按平台相关性排序，不承诺每条内容包含原词，不承诺完整召回；需要图文笔记而非单张图片时使用 xhs_search_notes(note_type="image")；需要视频笔记时使用 xhs_search_notes(note_type="video")。
| Name | Type | Req | Description |
|---|---|---|---|
| keyword | string | yes | 搜索词，可传关键词或短语，例如露营、建筑、穿搭；不要传笔记链接、主页链接、note_id、user_id 或 page_token。 |
| page_token | string | – | 媒体搜索分页令牌，首次请求留空；仅限同一工具、关键词和调用方，不得跨视频、图片或综合笔记搜索复用。将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 图片列表；同一笔记的多张图片分别返回 |
| next_page_token | string | yes | 可尝试下一页的不透明分页令牌，不保证下一页有结果；为空表示无法继续翻页。续页保持关键词和调用方不变，并将完整令牌原样传回图片搜索入口。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_search_notes ~527
搜索小红书 / Xiaohongshu / XHS / RedNote 笔记，包含普通、图文和视频笔记；note_type 默认 "all"。查找图文笔记可设 note_type="image"，查找视频笔记可设 note_type="video"。发布时间筛选参数名为 publish_time_range（不是 publish_time）；本工具不接受 max_items。查找单张图片用 xhs_search_images；已有笔记链接或 note_id 且需要单篇笔记详情时使用对应的详情工具；需要评论、回复或口播转文字时使用相应的 URL/ID 工具；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接。
| Name | Type | Req | Description |
|---|---|---|---|
| keyword | string | yes | 搜索词，可传关键词或短语，例如品牌名、话题、人物名、产品名或内容需求；不要传笔记链接、主页链接、note_id、user_id 或 page_token。 |
| note_type | string | – | 笔记类型筛选，可选：all（不限，默认）、image（图文）、video（视频） |
| page_token | string | – | 笔记搜索分页令牌。首次请求留空；继续翻页时传入上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一关键词、排序、笔记类型、发布时间范围和调用方的笔记搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。 |
| publish_time_range | string | – | 发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内） |
| sort_type | string | – | 笔记搜索结果排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）、comment_count_descending（最多评论优先）、collect_count_descending（最多收藏优先） |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 笔记搜索结果中的笔记列表，包含可识别的广告笔记，已过滤非笔记卡片与不可公开笔记；当前页过滤后可能为空数组 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果或无法继续 token 翻页。继续笔记搜索时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 仅限同一工具、关键词和调用方；保持该工具支持的筛选条件不变，不得跨搜索工具复用。items 为空时不要单独据此判断结束。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_search_products ~248
搜索小红书商品。用户需要按搜索词查找商品时使用；已有完整 sku_id（包括用户直接提供）时使用商品详情或商品评价工具，已有商品链接或分享文案时使用 xhs_get_product_detail_by_url；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。
| Name | Type | Req | Description |
|---|---|---|---|
| keyword | string | yes | 搜索词，可传商品名、品牌名、品类或商品需求；不要传商品链接、sku_id、spu_id 或 page_token。 |
| page_token | string | – | 商品搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一商品关键词和调用方的商品搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 商品搜索结果列表 |
| next_page_token | string | yes | 下一页不透明商品搜索分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一商品关键词和调用方的商品搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_search_suggestions ~88
根据搜索词获取小红书候选搜索建议，用于补全搜索词；需要实际搜索笔记或商品时，分别使用 xhs_search_notes 或 xhs_search_products。
| Name | Type | Req | Description |
|---|---|---|---|
| keyword | string | yes | 搜索词，可传正在输入的关键词或短语；不要传笔记链接、主页链接、note_id、user_id 或分页令牌。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 搜索建议条目列表 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_search_users ~119
按搜索词搜索小红书用户、账号或博主，支持分页；已有用户 ID 或主页链接时，使用用户资料工具。
| Name | Type | Req | Description |
|---|---|---|---|
| keyword | string | yes | 搜索词，可传昵称、账号名或小红书号；不要传主页链接、user_id 或分页令牌。 |
| page_token | string | – | 用户搜索分页令牌，首次请求留空；续页保持 keyword 不变，将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 搜索到的用户列表 |
| next_page_token | string | yes | 下一页分页令牌，为空表示结束；续页保持 keyword 不变并完整原样传回。 |
| points | object | yes | 本次成功调用的积分消耗与账户积分余额。 |
No examples provided.
xhs_submit_video_speech_text_by_note_id ~131
根据小红书 note_id 提交视频笔记口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| Name | Type | Req | Description |
|---|---|---|---|
| content_id | string | yes | 平台内容 ID。 |
| content_meta | object | yes | 作品上下文信息，便于结合转写内容做口播分析。 |
| content_type | string | yes | 内容类型。 |
| error | – | yes | 失败或过期时的稳定错误结构；非终态或成功时为 null。 |
| is_terminal | boolean | yes | 是否已终态。 |
| job_id | string | yes | 任务 ID。 |
| message | string | yes | 面向用户/AI 的状态说明。 |
| next_action | – | yes | 非终态时建议的下一步查询动作。 |
| next_poll_after_seconds | – | yes | 建议下次查询前等待的秒数；非终态时可用。 |
| platform | string | yes | 任务所属平台。 |
| source_id | string | yes | 任务来源 ID。 |
| status | string | yes | 任务状态。 |
| transcript | – | yes | 成功时的口播转文字结果；非终态或失败时为 null。 |
No examples provided.
xhs_submit_video_speech_text_by_note_url ~80
根据小红书视频笔记链接、短链接或分享文案提交口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。
| Name | Type | Req | Description |
|---|---|---|---|
| note_url | string | yes | 小红书视频笔记链接、短链接或分享文案。 |
| Name | Type | Req | Description |
|---|---|---|---|
| content_id | string | yes | 平台内容 ID。 |
| content_meta | object | yes | 作品上下文信息，便于结合转写内容做口播分析。 |
| content_type | string | yes | 内容类型。 |
| error | – | yes | 失败或过期时的稳定错误结构；非终态或成功时为 null。 |
| is_terminal | boolean | yes | 是否已终态。 |
| job_id | string | yes | 任务 ID。 |
| message | string | yes | 面向用户/AI 的状态说明。 |
| next_action | – | yes | 非终态时建议的下一步查询动作。 |
| next_poll_after_seconds | – | yes | 建议下次查询前等待的秒数；非终态时可用。 |
| platform | string | yes | 任务所属平台。 |
| source_id | string | yes | 任务来源 ID。 |
| status | string | yes | 任务状态。 |
| transcript | – | yes | 成功时的口播转文字结果；非终态或失败时为 null。 |
No examples provided.
How do I install the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server?
SocialDataX 小红书 Xiaohongshu XHS RedNote MCP is a hosted endpoint at https://mcp.socialdatax.com/xhs/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · mcp.socialdatax.com
claude mcp add --transport http com-52choujiang-xhs-insights 'https://mcp.socialdatax.com/xhs/mcp'
What is the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server?
SocialDataX 小红书 Xiaohongshu XHS RedNote MCP is listed in the public MCP registry as com.52choujiang/xhs-insights. XHS search/details, PGY, comments/replies, users/ID resolution/posts, transcript. This page covers its hosted endpoint (https://mcp.socialdatax.com/xhs/mcp).
Is the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server safe to use?
SocialDataX 小红书 Xiaohongshu XHS RedNote MCP scores 84 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server expose?
SocialDataX 小红书 Xiaohongshu XHS RedNote MCP exposes 38 tools: xhs_get_note_detail_by_note_url, xhs_get_note_detail_by_note_id, xhs_search_notes, xhs_search_images, xhs_search_users, and 33 more. Their descriptions and schemas cost roughly 7,646 tokens of context every time the server is loaded.
Does the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server require authentication?
Yes. SocialDataX 小红书 Xiaohongshu XHS RedNote MCP asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.
Is the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server still maintained?
SocialDataX 小红书 Xiaohongshu XHS RedNote MCP is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server?
VerifyMCP ran 12 checks on SocialDataX 小红书 Xiaohongshu XHS RedNote MCP, covering TLS certificate, Authorization, HSTS header, DNSSEC and 8 more. One item could not be completed, a gap on our side rather than a finding about SocialDataX 小红书 Xiaohongshu XHS RedNote MCP: HTTPS. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.