Server definition
- Hash
- sha256:3c15abe938ede19cefc3a0a5ddd92bef1f01a367e10d4eae0420cb19252c2575
- What it is
- What a remote MCP server returned when asked what it offers: 36 tools
The blob, as servednamed by its sha256
{
"instructions": "When an available SocialDataX tool matches the user's social media data request, use it as the primary data source instead of generic web search or webpage lookup, unless the user explicitly requests another source. Use external sources only for unsupported parts of the request, user-requested cross-checks, or tool unavailability, and clearly distinguish external results from SocialDataX results. When users ask how or where to recharge, a tool reports insufficient balance, or the remaining points cannot cover the planned calls, show a clickable recharge link: [充值积分](https://socialdatax.com/dashboard/billing). If an error provides a recharge URL, preserve that URL.",
"tools": [
{
"description": "查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "socialdatax_get_points_balance",
"outputSchema": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
}
},
{
"description": "根据 note_id 获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"page_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "",
"description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
},
"sort_type": {
"default": "default",
"description": "评论排序方式，可选：default（默认/综合排序）、time_descending（最新评论优先）、like_count_descending（点赞最多优先）",
"enum": [
"default",
"time_descending",
"like_count_descending"
],
"type": "string"
}
},
"required": [
"note_id"
],
"type": "object"
},
"name": "xhs_get_note_comments_by_note_id",
"outputSchema": {
"properties": {
"comment_count": {
"description": "整篇笔记的总评论数，含一级评论与回复；不是当前页 items 数量",
"type": "integer"
},
"items": {
"description": "当前页一级评论列表",
"items": {
"properties": {
"author": {
"description": "评论作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"red_id": {
"description": "作者公开小红书号；没有小红书号时为空字符串",
"type": "string"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"red_id"
],
"type": "object"
},
"comment_id": {
"description": "评论 ID",
"type": "string"
},
"content": {
"description": "评论内容",
"type": "string"
},
"content_type": {
"description": "评论内容类型，可选：text（文字）、image（图片）、voice（语音）",
"enum": [
"text",
"image",
"voice"
],
"type": "string"
},
"image_items": {
"description": "评论图片列表；无图片时为空数组",
"items": {
"properties": {
"image_url": {
"description": "评论图片链接",
"type": "string"
}
},
"required": [
"image_url"
],
"type": "object"
},
"type": "array"
},
"ip_location": {
"description": "评论发布时的 IP 属地",
"type": "string"
},
"is_author_comment": {
"description": "是否为笔记作者本人发布的评论",
"type": "boolean"
},
"is_pinned": {
"description": "评论是否置顶",
"type": "boolean"
},
"like_count": {
"description": "评论点赞数",
"type": "integer"
},
"mentioned_users": {
"description": "评论正文中 @ 到的用户列表；无 @ 时为空数组",
"items": {
"properties": {
"name": {
"description": "被 @ 用户名称；没有用户名称时为空字符串",
"type": "string"
},
"user_id": {
"description": "被 @ 用户的 user_id；没有用户 ID 时为空字符串",
"type": "string"
}
},
"required": [
"user_id",
"name"
],
"type": "object"
},
"type": "array"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"parent_comment_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "父评论 ID；一级评论通常为空"
},
"publish_time": {
"description": "评论发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"referenced_notes": {
"description": "评论中引用的笔记信息；无引用笔记时为空数组",
"items": {
"properties": {
"note_id": {
"description": "评论中引用的笔记 ID",
"type": "string"
},
"note_type": {
"description": "引用笔记类型，可选：image（图文）、video（视频）",
"enum": [
"image",
"video"
],
"type": "string"
},
"title": {
"description": "评论中引用的笔记标题",
"type": "string"
}
},
"required": [
"note_id",
"title",
"note_type"
],
"type": "object"
},
"type": "array"
},
"reply_count": {
"description": "评论回复数",
"type": "integer"
},
"voice_duration_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "兼容字段：语音评论时长，单位秒；非语音评论或没有时长时为 null"
},
"voice_info": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "语音时长，单位毫秒；没有时长时为 null"
}
},
"required": [
"duration_ms"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "语音评论时长信息；非语音评论时为 null"
}
},
"required": [
"comment_id",
"note_id",
"content",
"content_type",
"image_items",
"voice_info",
"voice_duration_seconds",
"mentioned_users",
"referenced_notes",
"publish_time",
"like_count",
"reply_count",
"parent_comment_id",
"is_pinned",
"is_author_comment",
"ip_location",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"top_level_comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "整篇笔记的一级评论总数，不含回复；不是当前页 items 数量；无法获取时为 null"
}
},
"required": [
"items",
"next_page_token",
"comment_count",
"top_level_comment_count",
"points"
],
"type": "object"
}
},
{
"description": "根据笔记链接、短链接或分享文案获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"note_url": {
"description": "小红书笔记链接、短链接或分享文案。支持以下形式：1) 小红书笔记长链接；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。",
"type": "string"
},
"page_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "",
"description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
},
"sort_type": {
"default": "default",
"description": "评论排序方式，可选：default（默认/综合排序）、time_descending（最新评论优先）、like_count_descending（点赞最多优先）",
"enum": [
"default",
"time_descending",
"like_count_descending"
],
"type": "string"
}
},
"required": [
"note_url"
],
"type": "object"
},
"name": "xhs_get_note_comments_by_note_url",
"outputSchema": {
"properties": {
"comment_count": {
"description": "整篇笔记的总评论数，含一级评论与回复；不是当前页 items 数量",
"type": "integer"
},
"items": {
"description": "当前页一级评论列表",
"items": {
"properties": {
"author": {
"description": "评论作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"red_id": {
"description": "作者公开小红书号；没有小红书号时为空字符串",
"type": "string"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"red_id"
],
"type": "object"
},
"comment_id": {
"description": "评论 ID",
"type": "string"
},
"content": {
"description": "评论内容",
"type": "string"
},
"content_type": {
"description": "评论内容类型，可选：text（文字）、image（图片）、voice（语音）",
"enum": [
"text",
"image",
"voice"
],
"type": "string"
},
"image_items": {
"description": "评论图片列表；无图片时为空数组",
"items": {
"properties": {
"image_url": {
"description": "评论图片链接",
"type": "string"
}
},
"required": [
"image_url"
],
"type": "object"
},
"type": "array"
},
"ip_location": {
"description": "评论发布时的 IP 属地",
"type": "string"
},
"is_author_comment": {
"description": "是否为笔记作者本人发布的评论",
"type": "boolean"
},
"is_pinned": {
"description": "评论是否置顶",
"type": "boolean"
},
"like_count": {
"description": "评论点赞数",
"type": "integer"
},
"mentioned_users": {
"description": "评论正文中 @ 到的用户列表；无 @ 时为空数组",
"items": {
"properties": {
"name": {
"description": "被 @ 用户名称；没有用户名称时为空字符串",
"type": "string"
},
"user_id": {
"description": "被 @ 用户的 user_id；没有用户 ID 时为空字符串",
"type": "string"
}
},
"required": [
"user_id",
"name"
],
"type": "object"
},
"type": "array"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"parent_comment_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "父评论 ID；一级评论通常为空"
},
"publish_time": {
"description": "评论发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"referenced_notes": {
"description": "评论中引用的笔记信息；无引用笔记时为空数组",
"items": {
"properties": {
"note_id": {
"description": "评论中引用的笔记 ID",
"type": "string"
},
"note_type": {
"description": "引用笔记类型，可选：image（图文）、video（视频）",
"enum": [
"image",
"video"
],
"type": "string"
},
"title": {
"description": "评论中引用的笔记标题",
"type": "string"
}
},
"required": [
"note_id",
"title",
"note_type"
],
"type": "object"
},
"type": "array"
},
"reply_count": {
"description": "评论回复数",
"type": "integer"
},
"voice_duration_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "兼容字段：语音评论时长，单位秒；非语音评论或没有时长时为 null"
},
"voice_info": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "语音时长，单位毫秒；没有时长时为 null"
}
},
"required": [
"duration_ms"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "语音评论时长信息；非语音评论时为 null"
}
},
"required": [
"comment_id",
"note_id",
"content",
"content_type",
"image_items",
"voice_info",
"voice_duration_seconds",
"mentioned_users",
"referenced_notes",
"publish_time",
"like_count",
"reply_count",
"parent_comment_id",
"is_pinned",
"is_author_comment",
"ip_location",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"top_level_comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "整篇笔记的一级评论总数，不含回复；不是当前页 items 数量；无法获取时为 null"
}
},
"required": [
"items",
"next_page_token",
"comment_count",
"top_level_comment_count",
"points"
],
"type": "object"
}
},
{
"description": "根据 note_id 获取单篇小红书笔记详情。\n返回的 note_url 非 null 时，在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
}
},
"required": [
"note_id"
],
"type": "object"
},
"name": "xhs_get_note_detail_by_note_id",
"outputSchema": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"description": "作者信息；详情页不返回小红书号",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"comment_count": {
"description": "评论数",
"type": "integer"
},
"content": {
"description": "笔记正文",
"type": "string"
},
"cover_image_url": {
"description": "统一封面图",
"type": "string"
},
"image_items": {
"description": "图片结构化明细；每项都表示一张图片，Live 图会在对应项携带 live_photo 摘要",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；没有时为 null"
},
"image_url": {
"description": "图片链接",
"type": "string"
},
"live_photo": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Live 图时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Live 图视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Live 图视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Live 图视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Live 图视频摘要；普通图片或没有视频摘要时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；没有时为 null"
}
},
"required": [
"image_url",
"width",
"height",
"live_photo"
],
"type": "object"
},
"type": "array"
},
"ip_location": {
"description": "笔记发布时的 IP 属地；没有 IP 属地时为空字符串",
"type": "string"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"mentioned_users": {
"description": "笔记正文中 @ 到的用户列表；无 @ 时为空数组",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "被 @ 用户名称；没有用户名称时为空字符串",
"type": "string"
},
"user_id": {
"description": "被 @ 用户的 user_id；没有用户 ID 时为空字符串",
"type": "string"
}
},
"required": [
"user_id",
"name"
],
"type": "object"
},
"type": "array"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"note_type": {
"description": "笔记类型；当前公开值固定为 image 或 video",
"enum": [
"image",
"video"
],
"type": "string"
},
"note_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。无法提供可用链接时为 null；note_url 为 null 时不要用 note_id 合成公开链接。"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"publish_time": {
"description": "发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"share_count": {
"description": "分享数",
"type": "integer"
},
"title": {
"description": "笔记标题",
"type": "string"
},
"topic_tags": {
"description": "笔记详情中的话题标签；无话题时为空数组",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "话题标签 ID；没有可用 ID 时为空字符串",
"type": "string"
},
"name": {
"description": "话题标签名称",
"type": "string"
}
},
"required": [
"name",
"id"
],
"type": "object"
},
"type": "array"
},
"update_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null"
},
"video": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "视频摘要信息；无可用视频摘要时为 null"
}
},
"required": [
"note_id",
"note_url",
"note_type",
"title",
"content",
"cover_image_url",
"image_items",
"video",
"like_count",
"collect_count",
"comment_count",
"share_count",
"publish_time",
"update_time",
"ip_location",
"topic_tags",
"mentioned_users",
"author",
"points"
],
"type": "object"
}
},
{
"description": "根据笔记链接、短链接或分享文案获取单篇小红书笔记详情。\n返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"note_url": {
"description": "小红书笔记链接、短链接或分享文案。支持以下形式：1) 小红书笔记长链接；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。",
"type": "string"
}
},
"required": [
"note_url"
],
"type": "object"
},
"name": "xhs_get_note_detail_by_note_url",
"outputSchema": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"description": "作者信息；详情页不返回小红书号",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"comment_count": {
"description": "评论数",
"type": "integer"
},
"content": {
"description": "笔记正文",
"type": "string"
},
"cover_image_url": {
"description": "统一封面图",
"type": "string"
},
"image_items": {
"description": "图片结构化明细；每项都表示一张图片，Live 图会在对应项携带 live_photo 摘要",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；没有时为 null"
},
"image_url": {
"description": "图片链接",
"type": "string"
},
"live_photo": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Live 图时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Live 图视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Live 图视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Live 图视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Live 图视频摘要；普通图片或没有视频摘要时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；没有时为 null"
}
},
"required": [
"image_url",
"width",
"height",
"live_photo"
],
"type": "object"
},
"type": "array"
},
"ip_location": {
"description": "笔记发布时的 IP 属地；没有 IP 属地时为空字符串",
"type": "string"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"mentioned_users": {
"description": "笔记正文中 @ 到的用户列表；无 @ 时为空数组",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "被 @ 用户名称；没有用户名称时为空字符串",
"type": "string"
},
"user_id": {
"description": "被 @ 用户的 user_id；没有用户 ID 时为空字符串",
"type": "string"
}
},
"required": [
"user_id",
"name"
],
"type": "object"
},
"type": "array"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"note_type": {
"description": "笔记类型；当前公开值固定为 image 或 video",
"enum": [
"image",
"video"
],
"type": "string"
},
"note_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。无法提供可用链接时为 null；note_url 为 null 时不要用 note_id 合成公开链接。"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"publish_time": {
"description": "发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"share_count": {
"description": "分享数",
"type": "integer"
},
"title": {
"description": "笔记标题",
"type": "string"
},
"topic_tags": {
"description": "笔记详情中的话题标签；无话题时为空数组",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "话题标签 ID；没有可用 ID 时为空字符串",
"type": "string"
},
"name": {
"description": "话题标签名称",
"type": "string"
}
},
"required": [
"name",
"id"
],
"type": "object"
},
"type": "array"
},
"update_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null"
},
"video": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "视频摘要信息；无可用视频摘要时为 null"
}
},
"required": [
"note_id",
"note_url",
"note_type",
"title",
"content",
"cover_image_url",
"image_items",
"video",
"like_count",
"collect_count",
"comment_count",
"share_count",
"publish_time",
"update_time",
"ip_location",
"topic_tags",
"mentioned_users",
"author",
"points"
],
"type": "object"
}
},
{
"description": "根据 note_id 和一级评论 comment_id 获取二级评论；用户已提供完整合法的 ID 组合时直接使用；已有 note_id 或笔记链接但缺少必需 ID 时，调用对应一级评论工具补全；缺少笔记定位信息时向用户索取；支持 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"comment_id": {
"description": "一级评论 ID；用户已提供时直接使用，否则可从一级评论结果 items[].comment_id 复制；不要传二级评论项自身的 comment_id。",
"type": "string"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"page_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "",
"description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一 note_id 和 comment_id 的二级评论列表，不能跨笔记或一级评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
}
},
"required": [
"note_id",
"comment_id"
],
"type": "object"
},
"name": "xhs_get_note_sub_comments_by_comment_id",
"outputSchema": {
"properties": {
"items": {
"description": "当前页二级评论列表",
"items": {
"properties": {
"author": {
"description": "评论作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"red_id": {
"description": "作者公开小红书号；没有小红书号时为空字符串",
"type": "string"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"red_id"
],
"type": "object"
},
"comment_id": {
"description": "评论 ID",
"type": "string"
},
"content": {
"description": "评论内容",
"type": "string"
},
"content_type": {
"description": "评论内容类型，可选：text（文字）、image（图片）、voice（语音）",
"enum": [
"text",
"image",
"voice"
],
"type": "string"
},
"image_items": {
"description": "评论图片列表；无图片时为空数组",
"items": {
"properties": {
"image_url": {
"description": "评论图片链接",
"type": "string"
}
},
"required": [
"image_url"
],
"type": "object"
},
"type": "array"
},
"ip_location": {
"description": "评论发布时的 IP 属地",
"type": "string"
},
"is_author_comment": {
"description": "是否为笔记作者本人发布的评论",
"type": "boolean"
},
"is_pinned": {
"description": "评论是否置顶",
"type": "boolean"
},
"like_count": {
"description": "评论点赞数",
"type": "integer"
},
"mentioned_users": {
"description": "评论正文中 @ 到的用户列表；无 @ 时为空数组",
"items": {
"properties": {
"name": {
"description": "被 @ 用户名称；没有用户名称时为空字符串",
"type": "string"
},
"user_id": {
"description": "被 @ 用户的 user_id；没有用户 ID 时为空字符串",
"type": "string"
}
},
"required": [
"user_id",
"name"
],
"type": "object"
},
"type": "array"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"parent_comment_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "父评论 ID；一级评论通常为空"
},
"publish_time": {
"description": "评论发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"referenced_notes": {
"description": "评论中引用的笔记信息；无引用笔记时为空数组",
"items": {
"properties": {
"note_id": {
"description": "评论中引用的笔记 ID",
"type": "string"
},
"note_type": {
"description": "引用笔记类型，可选：image（图文）、video（视频）",
"enum": [
"image",
"video"
],
"type": "string"
},
"title": {
"description": "评论中引用的笔记标题",
"type": "string"
}
},
"required": [
"note_id",
"title",
"note_type"
],
"type": "object"
},
"type": "array"
},
"reply_count": {
"description": "评论回复数",
"type": "integer"
},
"voice_duration_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "兼容字段：语音评论时长，单位秒；非语音评论或没有时长时为 null"
},
"voice_info": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "语音时长，单位毫秒；没有时长时为 null"
}
},
"required": [
"duration_ms"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "语音评论时长信息；非语音评论时为 null"
}
},
"required": [
"comment_id",
"note_id",
"content",
"content_type",
"image_items",
"voice_info",
"voice_duration_seconds",
"mentioned_users",
"referenced_notes",
"publish_time",
"like_count",
"reply_count",
"parent_comment_id",
"is_pinned",
"is_author_comment",
"ip_location",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一 note_id 和 comment_id 的二级评论列表，不能跨笔记或一级评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据小红书商品 sku_id 获取商品详情；已有该 ID 时直接使用，否则可从 xhs_search_products 获取。只有商品链接、短链接或分享文案时使用 xhs_get_product_detail_by_url；本工具不支持商品链接、spu_id 或搜索词。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"sku_id": {
"description": "小红书商品 SKU ID。用户已提供时原样使用；否则从 xhs_search_products 的 items[*].sku_id 原样复制。不支持 spu_id、商品链接或搜索关键词。",
"type": "string"
}
},
"required": [
"sku_id"
],
"type": "object"
},
"name": "xhs_get_product_detail_by_sku_id",
"outputSchema": {
"additionalProperties": false,
"properties": {
"assurances": {
"description": "商品保障服务列表",
"items": {
"type": "string"
},
"type": "array"
},
"coupon_price": {
"description": "当前 SKU 展示的券后/成交价格，单位：元；不保证是最终实付价",
"type": "number"
},
"detail_images": {
"description": "商品详情图列表",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"description": "原始图片高度；不一定等于 image_url 下载文件的像素高度",
"type": "integer"
},
"image_url": {
"description": "商品展示图片链接；可能为缩放图",
"type": "string"
},
"width": {
"description": "原始图片宽度；不一定等于 image_url 下载文件的像素宽度",
"type": "integer"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"main_images": {
"description": "商品顶部主图/轮播图列表",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"description": "原始图片高度；不一定等于 image_url 下载文件的像素高度",
"type": "integer"
},
"image_url": {
"description": "商品展示图片链接；可能为缩放图",
"type": "string"
},
"width": {
"description": "原始图片宽度；不一定等于 image_url 下载文件的像素宽度",
"type": "integer"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"price": {
"description": "当前 SKU 的商品原价，单位：元；不是商品搜索的展示销售价，也不是最终实付价",
"type": "number"
},
"sales_text": {
"description": "平台展示的商品销量文本；没有时为空字符串。带“+”的数量表示下限，不是精确销量；结合 sold_count 解读。",
"type": "string"
},
"selected_variant": {
"description": "当前选中规格；没有规格时为空字符串",
"type": "string"
},
"shipping": {
"additionalProperties": false,
"description": "发货信息",
"properties": {
"fee": {
"description": "运费展示文本；没有运费信息时为空字符串",
"type": "string"
},
"location": {
"description": "发货地；没有发货地时为空字符串",
"type": "string"
},
"text": {
"description": "发货说明；没有发货说明时为空字符串",
"type": "string"
}
},
"required": [
"location",
"fee",
"text"
],
"type": "object"
},
"shop_avatar_url": {
"description": "店铺头像链接",
"type": "string"
},
"shop_fans_text": {
"description": "店铺粉丝数展示值；没有粉丝信息时为空字符串",
"type": "string"
},
"shop_id": {
"description": "店铺 ID",
"type": "string"
},
"shop_name": {
"description": "店铺名称",
"type": "string"
},
"shop_score": {
"description": "店铺评分展示值；没有评分时为空字符串",
"type": "string"
},
"shop_sold_text": {
"description": "店铺已售展示值；没有已售信息时为空字符串",
"type": "string"
},
"sku_id": {
"description": "商品 SKU ID",
"type": "string"
},
"sold_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "已售数量；平台以带“+”的千级或万级文本展示时转换为对应整数下限（如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000），不是精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0。"
},
"specifications": {
"description": "商品属性/规格参数列表（name/value），不是可选 SKU 规格组",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "规格参数名称",
"type": "string"
},
"value": {
"description": "规格参数值",
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": "array"
},
"stock_status": {
"description": "库存状态码；具体码值含义未公开定义，不要自行解释为是否在售或是否可购买",
"type": "integer"
},
"title": {
"description": "商品标题",
"type": "string"
}
},
"required": [
"sku_id",
"title",
"price",
"coupon_price",
"sold_count",
"sales_text",
"stock_status",
"shop_id",
"shop_name",
"shop_avatar_url",
"main_images",
"detail_images",
"selected_variant",
"assurances",
"shipping",
"shop_score",
"shop_fans_text",
"shop_sold_text",
"specifications",
"points"
],
"type": "object"
}
},
{
"description": "根据小红书商品链接、短链接或分享文案获取商品详情，无需先搜索。已有完整 sku_id 时使用 xhs_get_product_detail_by_sku_id；返回的 sku_id 可继续用于商品评价工具。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"url": {
"description": "小红书商品详情链接、短链接或包含商品链接的完整分享文案。不支持笔记链接、博主主页链接、纯分享口令或搜索词。",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "xhs_get_product_detail_by_url",
"outputSchema": {
"additionalProperties": false,
"properties": {
"assurances": {
"description": "商品保障服务列表",
"items": {
"type": "string"
},
"type": "array"
},
"coupon_price": {
"description": "当前 SKU 展示的券后/成交价格，单位：元；不保证是最终实付价",
"type": "number"
},
"detail_images": {
"description": "商品详情图列表",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"description": "原始图片高度；不一定等于 image_url 下载文件的像素高度",
"type": "integer"
},
"image_url": {
"description": "商品展示图片链接；可能为缩放图",
"type": "string"
},
"width": {
"description": "原始图片宽度；不一定等于 image_url 下载文件的像素宽度",
"type": "integer"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"main_images": {
"description": "商品顶部主图/轮播图列表",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"description": "原始图片高度；不一定等于 image_url 下载文件的像素高度",
"type": "integer"
},
"image_url": {
"description": "商品展示图片链接；可能为缩放图",
"type": "string"
},
"width": {
"description": "原始图片宽度；不一定等于 image_url 下载文件的像素宽度",
"type": "integer"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"price": {
"description": "当前 SKU 的商品原价，单位：元；不是商品搜索的展示销售价，也不是最终实付价",
"type": "number"
},
"sales_text": {
"description": "平台展示的商品销量文本；没有时为空字符串。带“+”的数量表示下限，不是精确销量；结合 sold_count 解读。",
"type": "string"
},
"selected_variant": {
"description": "当前选中规格；没有规格时为空字符串",
"type": "string"
},
"shipping": {
"additionalProperties": false,
"description": "发货信息",
"properties": {
"fee": {
"description": "运费展示文本；没有运费信息时为空字符串",
"type": "string"
},
"location": {
"description": "发货地；没有发货地时为空字符串",
"type": "string"
},
"text": {
"description": "发货说明；没有发货说明时为空字符串",
"type": "string"
}
},
"required": [
"location",
"fee",
"text"
],
"type": "object"
},
"shop_avatar_url": {
"description": "店铺头像链接",
"type": "string"
},
"shop_fans_text": {
"description": "店铺粉丝数展示值；没有粉丝信息时为空字符串",
"type": "string"
},
"shop_id": {
"description": "店铺 ID",
"type": "string"
},
"shop_name": {
"description": "店铺名称",
"type": "string"
},
"shop_score": {
"description": "店铺评分展示值；没有评分时为空字符串",
"type": "string"
},
"shop_sold_text": {
"description": "店铺已售展示值；没有已售信息时为空字符串",
"type": "string"
},
"sku_id": {
"description": "商品 SKU ID",
"type": "string"
},
"sold_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "已售数量；平台以带“+”的千级或万级文本展示时转换为对应整数下限（如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000），不是精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0。"
},
"specifications": {
"description": "商品属性/规格参数列表（name/value），不是可选 SKU 规格组",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "规格参数名称",
"type": "string"
},
"value": {
"description": "规格参数值",
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": "array"
},
"stock_status": {
"description": "库存状态码；具体码值含义未公开定义，不要自行解释为是否在售或是否可购买",
"type": "integer"
},
"title": {
"description": "商品标题",
"type": "string"
}
},
"required": [
"sku_id",
"title",
"price",
"coupon_price",
"sold_count",
"sales_text",
"stock_status",
"shop_id",
"shop_name",
"shop_avatar_url",
"main_images",
"detail_images",
"selected_variant",
"assurances",
"shipping",
"shop_score",
"shop_fans_text",
"shop_sold_text",
"specifications",
"points"
],
"type": "object"
}
},
{
"description": "根据一级商品评价 review_id 获取其下回复；已有该 ID 时直接使用，否则可从 xhs_get_product_reviews 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page_token": {
"default": "",
"description": "商品评价回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一一级评价和调用方，不能跨链路复用。",
"type": "string"
},
"review_id": {
"description": "一级商品评价 ID。用户已提供时原样使用；否则从 xhs_get_product_reviews 的 items[*].review_id 原样复制。不要传 root_review_id。",
"type": "string"
}
},
"required": [
"review_id"
],
"type": "object"
},
"name": "xhs_get_product_review_replies",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "当前页商品评价回复列表",
"items": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"description": "回复作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称；没有作者名时为空字符串",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object"
},
"content": {
"description": "回复内容；无法获取时为空字符串",
"type": "string"
},
"ip_location": {
"description": "回复 IP 属地；无法获取时为空字符串",
"type": "string"
},
"like_count": {
"description": "回复点赞数；无法获取时为 0",
"type": "integer"
},
"mentioned_users": {
"description": "回复正文中 @ 到的用户列表",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "被 @ 用户名称；无法获取时为空字符串",
"type": "string"
},
"user_id": {
"description": "被 @ 用户的 user_id；无法获取时为空字符串",
"type": "string"
}
},
"required": [
"user_id",
"name"
],
"type": "object"
},
"type": "array"
},
"publish_time_text": {
"description": "回复时间展示文本；无法获取时为空字符串",
"type": "string"
},
"reply_to_review_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "直接回复对象 ID；直接回复一级评价时为 null"
},
"review_id": {
"description": "当前回复自身 ID",
"type": "string"
},
"root_review_id": {
"description": "完整商品评价线程 ID",
"type": "string"
}
},
"required": [
"review_id",
"root_review_id",
"reply_to_review_id",
"content",
"like_count",
"publish_time_text",
"ip_location",
"mentioned_users",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明商品评价回复分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须原样传回，只能用于同一一级评价和调用方。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据商品评价回复 review_id 获取其下的嵌套回复；已有该 ID 时直接使用，否则可从 xhs_get_product_review_replies 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page_token": {
"default": "",
"description": "商品评价回复的回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一父级回复和调用方，不能跨链路复用。",
"type": "string"
},
"review_id": {
"description": "商品评价回复 ID。用户已提供时原样使用；否则从 xhs_get_product_review_replies 的 items[*].review_id 原样复制。不要传 root_review_id。",
"type": "string"
}
},
"required": [
"review_id"
],
"type": "object"
},
"name": "xhs_get_product_review_reply_replies",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "当前页商品评价回复的回复列表",
"items": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"description": "回复作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称；没有作者名时为空字符串",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object"
},
"content": {
"description": "回复内容；无法获取时为空字符串",
"type": "string"
},
"ip_location": {
"description": "回复 IP 属地；无法获取时为空字符串",
"type": "string"
},
"like_count": {
"description": "回复点赞数；无法获取时为 0",
"type": "integer"
},
"mentioned_users": {
"description": "回复正文中 @ 到的用户列表",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "被 @ 用户名称；无法获取时为空字符串",
"type": "string"
},
"user_id": {
"description": "被 @ 用户的 user_id；无法获取时为空字符串",
"type": "string"
}
},
"required": [
"user_id",
"name"
],
"type": "object"
},
"type": "array"
},
"publish_time_text": {
"description": "回复时间展示文本；无法获取时为空字符串",
"type": "string"
},
"reply_to_review_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "直接回复对象 ID；直接回复一级评价时为 null"
},
"review_id": {
"description": "当前回复自身 ID",
"type": "string"
},
"root_review_id": {
"description": "完整商品评价线程 ID",
"type": "string"
}
},
"required": [
"review_id",
"root_review_id",
"reply_to_review_id",
"content",
"like_count",
"publish_time_text",
"ip_location",
"mentioned_users",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明商品评价回复的回复分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须原样传回，只能用于同一父级回复和调用方。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据小红书商品 sku_id 获取商品评价；已有该 ID 时直接使用，否则可从 xhs_search_products 获取；支持 sort_type、has_image 和 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不支持商品链接、spu_id 或搜索词。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"has_image": {
"default": false,
"description": "是否只返回带图片的商品评价",
"type": "boolean"
},
"page_token": {
"default": "",
"description": "商品评价分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一商品 SKU、排序、图片筛选和调用方的商品评价链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"sku_id": {
"description": "小红书商品 SKU ID。用户已提供时原样使用；否则从 xhs_search_products 的 items[*].sku_id 原样复制。不支持 spu_id、商品链接或搜索关键词。",
"type": "string"
},
"sort_type": {
"default": "general",
"description": "商品评价排序方式，可选：general（综合，默认）、time_descending（最新评价优先）",
"enum": [
"general",
"time_descending"
],
"type": "string"
}
},
"required": [
"sku_id"
],
"type": "object"
},
"name": "xhs_get_product_reviews",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "当前页商品评价列表",
"items": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"description": "评价作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称；没有作者名时为空字符串",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object"
},
"content": {
"description": "评价文字内容；图片评价可能没有文字，此时为空字符串",
"type": "string"
},
"image_items": {
"description": "评价图片列表",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"description": "评价原图高度；无法获取时为 0",
"type": "integer"
},
"image_url": {
"description": "评价原图链接",
"type": "string"
},
"thumbnail_url": {
"description": "评价图片缩略图链接；没有缩略图链接时为空字符串",
"type": "string"
},
"width": {
"description": "评价原图宽度；无法获取时为 0",
"type": "integer"
}
},
"required": [
"image_url",
"thumbnail_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"like_count": {
"description": "评价点赞数；无法获取时为 0",
"type": "integer"
},
"logistics_score": {
"description": "物流评分，通常为 1-5；0 表示无法获取",
"type": "integer"
},
"product_score": {
"description": "商品评分，通常为 1-5；0 表示无法获取",
"type": "integer"
},
"publish_time_text": {
"description": "评价时间展示文本；可能是相对时间（如 1小时前）、月日（如 08-05）或完整日期（如 2025-06-13）；不是 Unix 时间戳，不要自行补全年份或时分秒；无法获取时为空字符串",
"type": "string"
},
"purchased_variants": {
"description": "购买时选择的商品规格列表",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "购买规格名称",
"type": "string"
},
"value": {
"description": "购买规格值",
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": "array"
},
"review_id": {
"description": "评价 ID；无法获取时为空字符串",
"type": "string"
},
"service_score": {
"description": "服务评分，通常为 1-5；0 表示无法获取",
"type": "integer"
}
},
"required": [
"content",
"like_count",
"review_id",
"publish_time_text",
"image_items",
"product_score",
"logistics_score",
"service_score",
"purchased_variants",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明商品评价分页令牌；items 为空时仍应继续翻页；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一商品 SKU、排序、图片筛选和调用方的商品评价链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "获取小红书搜索热榜。",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "xhs_get_search_hot_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "搜索热榜条目列表",
"items": {
"additionalProperties": false,
"properties": {
"hot_value": {
"description": "热度值",
"type": "integer"
},
"title": {
"description": "热榜标题",
"type": "string"
}
},
"required": [
"title",
"hot_value"
],
"type": "object"
},
"type": "array"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"points"
],
"type": "object"
}
},
{
"description": "根据 page_id 获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page_id": {
"description": "小红书标签页 page_id。",
"type": "string"
},
"page_token": {
"default": "",
"description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"sort_type": {
"default": "hot",
"description": "标签页笔记排序方式，可选：hot（最热，默认）、time_descending（最新）",
"enum": [
"hot",
"time_descending"
],
"type": "string"
}
},
"required": [
"page_id"
],
"type": "object"
},
"name": "xhs_get_topic_notes_by_page_id",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "标签页笔记列表",
"items": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"description": "作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object"
},
"cover_image_url": {
"description": "统一封面图",
"type": "string"
},
"image_items": {
"description": "图片列表；无图片时为空数组",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；没有时为 null"
},
"image_url": {
"description": "图片链接",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；没有时为 null"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"note_type": {
"description": "笔记类型；当前公开值固定为 image 或 video",
"enum": [
"image",
"video"
],
"type": "string"
},
"publish_time": {
"description": "发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"title": {
"description": "笔记标题",
"type": "string"
},
"video": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频原始时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "视频摘要信息；视频笔记有可用视频摘要时返回对象，图文或无可用视频摘要时为 null"
}
},
"required": [
"note_id",
"note_type",
"title",
"cover_image_url",
"image_items",
"video",
"like_count",
"publish_time",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；非空表示可尝试请求下一页，为空表示当前没有可继续的下一页令牌。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；items 为空时不要单独据此判断结束；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"total_note_count": {
"description": "标签页笔记总数",
"type": "integer"
},
"total_user_count": {
"description": "标签页涉及用户总数",
"type": "integer"
}
},
"required": [
"items",
"next_page_token",
"total_note_count",
"total_user_count",
"points"
],
"type": "object"
}
},
{
"description": "根据话题页链接、短链接或分享文案获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page_token": {
"default": "",
"description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"sort_type": {
"default": "hot",
"description": "标签页笔记排序方式，可选：hot（最热，默认）、time_descending（最新）",
"enum": [
"hot",
"time_descending"
],
"type": "string"
},
"topic_url": {
"description": "小红书话题页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/topic/normal/... 话题页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。",
"type": "string"
}
},
"required": [
"topic_url"
],
"type": "object"
},
"name": "xhs_get_topic_notes_by_topic_url",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "标签页笔记列表",
"items": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"description": "作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object"
},
"cover_image_url": {
"description": "统一封面图",
"type": "string"
},
"image_items": {
"description": "图片列表；无图片时为空数组",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；没有时为 null"
},
"image_url": {
"description": "图片链接",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；没有时为 null"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"note_type": {
"description": "笔记类型；当前公开值固定为 image 或 video",
"enum": [
"image",
"video"
],
"type": "string"
},
"publish_time": {
"description": "发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"title": {
"description": "笔记标题",
"type": "string"
},
"video": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频原始时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "视频摘要信息；视频笔记有可用视频摘要时返回对象，图文或无可用视频摘要时为 null"
}
},
"required": [
"note_id",
"note_type",
"title",
"cover_image_url",
"image_items",
"video",
"like_count",
"publish_time",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；非空表示可尝试请求下一页，为空表示当前没有可继续的下一页令牌。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；items 为空时不要单独据此判断结束；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"total_note_count": {
"description": "标签页笔记总数",
"type": "integer"
},
"total_user_count": {
"description": "标签页涉及用户总数",
"type": "integer"
}
},
"required": [
"items",
"next_page_token",
"total_note_count",
"total_user_count",
"points"
],
"type": "object"
}
},
{
"description": "根据完整加密用户 ID 获取稳定 user_id。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"encrypted_user_id": {
"description": "小红书加密用户 ID。用户已提供时直接原样使用；请传入完整 29 位小写十六进制值；不要传 24 位 user_id、小红书号、昵称或主页链接",
"type": "string"
}
},
"required": [
"encrypted_user_id"
],
"type": "object"
},
"name": "xhs_get_user_id_by_encrypted_user_id",
"outputSchema": {
"additionalProperties": false,
"properties": {
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"user_id": {
"description": "稳定用户 user_id",
"type": "string"
}
},
"required": [
"user_id",
"points"
],
"type": "object"
}
},
{
"description": "根据主页链接、短链接或分享文案获取单个小红书用户信息。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"profile_url": {
"description": "小红书主页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/user/profile/... 主页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。请传主页链接，不要传笔记链接。",
"type": "string"
}
},
"required": [
"profile_url"
],
"type": "object"
},
"name": "xhs_get_user_info_by_profile_url",
"outputSchema": {
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；没有头像链接时为 null"
},
"bio": {
"description": "用户个人简介（biography）；没有简介时为空字符串",
"type": "string"
},
"follower_count": {
"description": "粉丝数",
"type": "integer"
},
"following_count": {
"description": "关注数",
"type": "integer"
},
"ip_location": {
"description": "用户 IP 属地；没有 IP 属地时为空字符串",
"type": "string"
},
"is_enterprise_account": {
"description": "是否为企业账号",
"type": "boolean"
},
"is_professional_account": {
"description": "是否为专业号",
"type": "boolean"
},
"name": {
"description": "用户名称",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"posted_note_count": {
"description": "已发布笔记数",
"type": "integer"
},
"profile_tags": {
"description": "主页头部标签名称列表；没有标签时为空数组",
"items": {
"type": "string"
},
"type": "array"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；没有主页链接时为 null"
},
"received_collect_count": {
"description": "用户内容累计被收藏数",
"type": "integer"
},
"received_like_count": {
"description": "用户内容累计收到的点赞数",
"type": "integer"
},
"red_id": {
"description": "用户公开小红书号；没有小红书号时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id",
"type": "string"
},
"verification_category": {
"description": "认证补充信息；可能是行业类目或认证主体名称；未认证或没有认证信息时为空字符串",
"type": "string"
},
"verification_name": {
"description": "认证主体名称；没有认证主体时为空字符串",
"type": "string"
},
"verified": {
"description": "是否已认证",
"type": "boolean"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"red_id",
"bio",
"verified",
"verification_category",
"is_professional_account",
"verification_name",
"is_enterprise_account",
"profile_tags",
"follower_count",
"following_count",
"posted_note_count",
"received_like_count",
"received_collect_count",
"ip_location",
"points"
],
"type": "object"
}
},
{
"description": "根据 user_id 获取单个小红书用户信息。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"user_id": {
"description": "小红书用户 user_id。用户已提供时原样使用；否则可从笔记搜索、商品评价、商品评价回复、笔记详情、标签页笔记列表、用户信息或用户发帖列表结果中的 user_id/author.user_id 复制；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称。",
"type": "string"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "xhs_get_user_info_by_user_id",
"outputSchema": {
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；没有头像链接时为 null"
},
"bio": {
"description": "用户个人简介（biography）；没有简介时为空字符串",
"type": "string"
},
"follower_count": {
"description": "粉丝数",
"type": "integer"
},
"following_count": {
"description": "关注数",
"type": "integer"
},
"ip_location": {
"description": "用户 IP 属地；没有 IP 属地时为空字符串",
"type": "string"
},
"is_enterprise_account": {
"description": "是否为企业账号",
"type": "boolean"
},
"is_professional_account": {
"description": "是否为专业号",
"type": "boolean"
},
"name": {
"description": "用户名称",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"posted_note_count": {
"description": "已发布笔记数",
"type": "integer"
},
"profile_tags": {
"description": "主页头部标签名称列表；没有标签时为空数组",
"items": {
"type": "string"
},
"type": "array"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；没有主页链接时为 null"
},
"received_collect_count": {
"description": "用户内容累计被收藏数",
"type": "integer"
},
"received_like_count": {
"description": "用户内容累计收到的点赞数",
"type": "integer"
},
"red_id": {
"description": "用户公开小红书号；没有小红书号时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id",
"type": "string"
},
"verification_category": {
"description": "认证补充信息；可能是行业类目或认证主体名称；未认证或没有认证信息时为空字符串",
"type": "string"
},
"verification_name": {
"description": "认证主体名称；没有认证主体时为空字符串",
"type": "string"
},
"verified": {
"description": "是否已认证",
"type": "boolean"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"red_id",
"bio",
"verified",
"verification_category",
"is_professional_account",
"verification_name",
"is_enterprise_account",
"profile_tags",
"follower_count",
"following_count",
"posted_note_count",
"received_like_count",
"received_collect_count",
"ip_location",
"points"
],
"type": "object"
}
},
{
"description": "根据主页链接、短链接或分享文案获取用户已发布笔记列表，支持 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "",
"description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
},
"profile_url": {
"description": "小红书主页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/user/profile/... 主页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。请传主页链接，不要传笔记链接。",
"type": "string"
}
},
"required": [
"profile_url"
],
"type": "object"
},
"name": "xhs_get_user_posted_notes_by_profile_url",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "当前页用户发帖摘要列表",
"items": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"description": "作者信息；用户发帖列表不返回小红书号",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"comment_count": {
"description": "评论数",
"type": "integer"
},
"cover_image_url": {
"description": "统一封面图",
"type": "string"
},
"is_pinned": {
"description": "是否为置顶笔记",
"type": "boolean"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"note_type": {
"description": "笔记类型；当前公开值固定为 image 或 video",
"enum": [
"image",
"video"
],
"type": "string"
},
"note_url": {
"description": "笔记页面地址，不包含访问参数；可直接传给支持笔记链接的详情、评论或口播转文字工具继续使用。",
"minLength": 1,
"type": "string"
},
"publish_time": {
"description": "发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"share_count": {
"description": "分享数",
"type": "integer"
},
"summary": {
"description": "笔记摘要；不是全文",
"type": "string"
},
"title": {
"description": "笔记标题",
"type": "string"
},
"update_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null"
},
"video": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频原始时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "视频摘要信息；仅视频笔记返回对象，图文为 null"
}
},
"required": [
"note_id",
"note_url",
"note_type",
"title",
"summary",
"cover_image_url",
"like_count",
"collect_count",
"comment_count",
"share_count",
"publish_time",
"update_time",
"video",
"author",
"is_pinned"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据 user_id 获取用户已发布笔记列表，支持 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "",
"description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
},
"user_id": {
"description": "小红书用户 user_id。用户已提供时原样使用；否则可从笔记搜索、商品评价、商品评价回复、笔记详情、标签页笔记列表、用户信息或用户发帖列表结果中的 user_id/author.user_id 复制；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称。",
"type": "string"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "xhs_get_user_posted_notes_by_user_id",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "当前页用户发帖摘要列表",
"items": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"description": "作者信息；用户发帖列表不返回小红书号",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"comment_count": {
"description": "评论数",
"type": "integer"
},
"cover_image_url": {
"description": "统一封面图",
"type": "string"
},
"is_pinned": {
"description": "是否为置顶笔记",
"type": "boolean"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"note_type": {
"description": "笔记类型；当前公开值固定为 image 或 video",
"enum": [
"image",
"video"
],
"type": "string"
},
"note_url": {
"description": "笔记页面地址，不包含访问参数；可直接传给支持笔记链接的详情、评论或口播转文字工具继续使用。",
"minLength": 1,
"type": "string"
},
"publish_time": {
"description": "发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"share_count": {
"description": "分享数",
"type": "integer"
},
"summary": {
"description": "笔记摘要；不是全文",
"type": "string"
},
"title": {
"description": "笔记标题",
"type": "string"
},
"update_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null"
},
"video": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频原始时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "视频摘要信息；仅视频笔记返回对象，图文为 null"
}
},
"required": [
"note_id",
"note_url",
"note_type",
"title",
"summary",
"cover_image_url",
"like_count",
"collect_count",
"comment_count",
"share_count",
"publish_time",
"update_time",
"video",
"author",
"is_pinned"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据用户提供的有效 job_id，或提交工具返回的 job_id 查询任务状态；用于继续未完成任务，每次最多等待 240 秒，不触发重处理，也不要重复提交任务。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"job_id": {
"description": "口播转文字任务 ID；用户已提供时直接使用，否则使用提交工具返回的 job_id；不要传 note_id 或笔记链接。",
"type": "string"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "xhs_get_video_speech_text_job",
"outputSchema": {
"additionalProperties": false,
"properties": {
"content_id": {
"description": "平台内容 ID。",
"type": "string"
},
"content_meta": {
"additionalProperties": false,
"description": "作品上下文信息，便于结合转写内容做口播分析。",
"properties": {
"author": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接。"
},
"name": {
"description": "作者昵称。",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接。"
},
"user_id": {
"description": "作者用户 ID。",
"type": "string"
}
},
"required": [
"user_id",
"name",
"profile_url",
"avatar_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作者信息。"
},
"content_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品链接。"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "平台作品原始描述、正文或配文。"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "音视频时长，单位毫秒。"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品标题；平台无标题时为 null。"
}
},
"required": [
"content_url",
"title",
"description",
"duration_ms",
"author"
],
"type": "object"
},
"content_type": {
"description": "内容类型。",
"type": "string"
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"description": "稳定错误码。",
"type": "string"
},
"message": {
"description": "面向用户的错误说明。",
"type": "string"
},
"retryable": {
"default": false,
"description": "是否可重试。",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
},
"is_terminal": {
"description": "是否已终态。",
"type": "boolean"
},
"job_id": {
"description": "任务 ID。",
"type": "string"
},
"message": {
"description": "面向用户/AI 的状态说明。",
"type": "string"
},
"next_action": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"description": "下一步查询工具可直接使用的参数。",
"type": "object"
},
"instruction": {
"description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
"type": "string"
},
"job_id": {
"description": "需要继续查询的 job_id。",
"type": "string"
},
"tool_name": {
"description": "下一步建议调用的查询工具。",
"type": "string"
}
},
"required": [
"tool_name",
"job_id",
"arguments",
"instruction"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "非终态时建议的下一步查询动作。"
},
"next_poll_after_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "建议下次查询前等待的秒数；非终态时可用。"
},
"platform": {
"description": "任务所属平台。",
"type": "string"
},
"source_id": {
"description": "任务来源 ID。",
"type": "string"
},
"status": {
"description": "任务状态。",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"expired"
],
"type": "string"
},
"transcript": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"segments": {
"description": "按时间顺序排列的分段结果。",
"items": {
"additionalProperties": false,
"properties": {
"end_ms": {
"description": "分段结束时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"start_ms": {
"description": "分段开始时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"text": {
"description": "分段文本。",
"type": "string"
}
},
"required": [
"start_ms",
"end_ms",
"text"
],
"type": "object"
},
"type": "array"
},
"text": {
"description": "完整口播转文字结果。",
"type": "string"
}
},
"required": [
"text",
"segments"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "成功时的口播转文字结果；非终态或失败时为 null。"
}
},
"required": [
"job_id",
"status",
"is_terminal",
"platform",
"content_id",
"source_id",
"content_type",
"content_meta",
"transcript",
"error",
"next_poll_after_seconds",
"next_action",
"message"
],
"type": "object"
}
},
{
"description": "根据完整 user_id 获取小红书蒲公英创作者商业概览：笔记规模和中位数、服务表现、平台标签、增长、预估成本及对比值。\n查询指定日常/合作口径的商业汇总与成本参考时使用，不返回逐篇明细。逐篇表现使用创作者笔记表现工具，也可选择日常或合作口径。资料与报价使用创作者档案工具，粉丝构成使用粉丝画像工具。\n查看日常内容表现选 daily（默认，不是按天汇总）；查看商单、品牌合作笔记或外溢进店的汇总表现选 cooperation。输出回显口径，不能混用；不是对全部字段统一筛选，note_count 不能解释为所选口径的笔记数。两种口径的成本估计依据不同，均不代表实际成交成本或ROI。\n不支持指定日期，统计截止日期未提供；进店不等于订单或成交，不据此推断调用方自己的投放成绩。\n成功直接返回业务字段和 points；成功调用扣减 20 积分，失败不扣费。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"note_scope": {
"default": "daily",
"description": "笔记统计口径：查看日常内容表现选 daily（默认），不是按天汇总；查看商单、品牌合作笔记或外溢进店表现选 cooperation；输出回显实际口径，不能混用；不表示所有字段均按此口径拆分，note_count 等字段按各自说明解读",
"enum": [
"daily",
"cooperation"
],
"type": "string"
},
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "xhs_pgy_get_creator_commercial_overview",
"outputSchema": {
"additionalProperties": false,
"properties": {
"active_days_7d": {
"anyOf": [
{
"maximum": 7,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台 7 天统计窗口内登录小红书 App 的天数；截止日期未提供，不按查询日期或 data_date 推算起止日期，不等同发布笔记天数；未知时为 null"
},
"commercial_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "平台给出的商业标签原文，仅作平台评价展示，不作为独立评价结论；未知时为 null"
},
"commercial_label_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "平台商业标签说明原文；涉及排名或比较的文字仅代表平台说法，不提取为独立排名或百分位数值；未知时为 null"
},
"content_tags": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"ratio": {
"description": "该内容标签占比，0.1 表示 10%",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"tag": {
"description": "笔记内容标签",
"type": "string"
}
},
"required": [
"tag",
"ratio"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "平台 30 天窗口发布笔记的 TOP2 内容类目及笔记数量占比；不代表完整分布，不归一化或补其他，不保证与笔记表现接口同口径；未知时为 null，明确为空时为 []"
},
"data_date": {
"anyOf": [
{
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
{
"type": "null"
}
],
"description": "平台标注的数据日期（YYYY-MM-DD）；不代表查询时间或各指标统计截止日期；未知时为 null"
},
"estimated_picture_cpm": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台预估图文 CPM，单位人民币元/千次曝光；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null"
},
"estimated_picture_cpm_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文 CPM，不是实际成本或 ROI；相应预估成本不可用时为 null"
},
"estimated_picture_interaction_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台预估图文互动单价，单位人民币元/次互动；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null"
},
"estimated_picture_interaction_cost_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文互动单价，不是实际成本或 ROI；相应预估成本不可用时为 null"
},
"estimated_picture_read_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台预估图文阅读单价，单位人民币元/次阅读；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null"
},
"estimated_picture_read_cost_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文阅读单价，不是实际成本或 ROI；相应预估成本不可用时为 null"
},
"estimated_picture_store_visit_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台预估图文外溢进店单价，人民币元/进店；依据近30天跨域合作笔记价格及进店UV估计，不是成交成本或ROI；daily、不可预估、零值或未知时为 null"
},
"estimated_picture_store_visit_cost_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文进店单价，不是实际成本或ROI；daily 或对应成本不可用时为 null"
},
"estimated_video_cpm": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台预估视频 CPM，单位人民币元/千次曝光；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null"
},
"estimated_video_cpm_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频 CPM，不是实际成本或 ROI；相应预估成本不可用时为 null"
},
"estimated_video_interaction_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台预估视频互动单价，单位人民币元/次互动；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null"
},
"estimated_video_interaction_cost_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频互动单价，不是实际成本或 ROI；相应预估成本不可用时为 null"
},
"estimated_video_read_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台预估视频阅读单价，单位人民币元/次阅读；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null"
},
"estimated_video_read_cost_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频阅读单价，不是实际成本或 ROI；相应预估成本不可用时为 null"
},
"estimated_video_store_visit_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台预估视频外溢进店单价，人民币元/进店；依据近30天跨域合作笔记价格及进店UV估计，不是成交成本或ROI；daily、不可预估、零值或未知时为 null"
},
"estimated_video_store_visit_cost_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频进店单价，不是实际成本或ROI；daily 或对应成本不可用时为 null"
},
"follower_growth_benchmark_rate_30d": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天粉丝增长指标，窗口截止日期未提供；不是实际粉丝增长率"
},
"follower_growth_rate_30d": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "平台 30 天统计窗口的粉丝增长率，0.1 表示 10%；不是构成占比，不限于 0–1。截止日期和计算基数未提供，不按查询日期或 data_date 推算窗口，不与其他周期增长率混用；未知时为 null"
},
"impression_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记曝光中位数，不保证与笔记表现接口同口径"
},
"impression_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台 30 天窗口内所选口径笔记的曝光量中位数，不是累计曝光量；截止日期未提供，不用其他接口明细复算；未知时为 null"
},
"industry_labels": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "平台 30 天窗口内 TOP2 合作品牌行业；原样保留，不代表全部行业或具体品牌合作清单，不保证与创作者档案同口径；未知时为 null，明确为空时为 []"
},
"interaction_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记中位数，不保证与笔记表现接口同口径"
},
"interaction_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台 30 天窗口内所选口径笔记的互动量中位数，不是累计互动量；截止日期未提供，互动构成按平台口径，不用其他接口明细复算；未知时为 null"
},
"invitation_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台返回的邀约数量；统计周期、邀约方向及状态范围未明确，不等于成交或成功合作数量；未知时为 null"
},
"note_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台 30 天窗口内发布笔记数；不能因 note_scope=daily/cooperation 就解释为日常/合作笔记数量，不作为所选口径中位数的样本数量；不代表全部历史，截止日期未提供；未知时为 null"
},
"note_scope": {
"description": "笔记统计口径：查看日常内容表现选 daily（默认），不是按天汇总；查看商单、品牌合作笔记或外溢进店表现选 cooperation；输出回显实际口径，不能混用；不表示所有字段均按此口径拆分，note_count 等字段按各自说明解读",
"enum": [
"daily",
"cooperation"
],
"type": "string"
},
"outbound_store_visit_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应合作笔记外溢进店中位数；daily 时为 null"
},
"outbound_store_visit_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台30天合作笔记范围内的外溢进店量中位数；不是累计人数、订单数或成交额，窗口截止日未明确；daily 或未知时为 null"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"read_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记中位数，不保证与笔记表现接口同口径"
},
"read_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台 30 天窗口内所选口径笔记的阅读量中位数，不是累计阅读量；截止日期未提供，不用其他接口明细复算；未知时为 null"
},
"response_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "历史邀约合作消息在 48 小时内回复的比例，0.852 表示 85.2%；48 小时是回复时限，不是统计周期；累计周期和完整分母未提供，不用邀约数推算回复次数；邀约数不足 3 时不用于评价回复表现，不视为合作接受率；未知时为 null"
},
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
}
},
"required": [
"user_id",
"note_scope",
"data_date",
"invitation_count",
"response_rate",
"active_days_7d",
"industry_labels",
"note_count",
"read_median",
"interaction_median",
"content_tags",
"commercial_label",
"commercial_label_description",
"follower_growth_rate_30d",
"read_benchmark_rate",
"interaction_benchmark_rate",
"follower_growth_benchmark_rate_30d",
"impression_median",
"impression_benchmark_rate",
"estimated_picture_cpm",
"estimated_video_cpm",
"estimated_picture_read_cost",
"estimated_video_read_cost",
"estimated_picture_interaction_cost",
"estimated_video_interaction_cost",
"estimated_picture_cpm_benchmark_rate",
"estimated_video_cpm_benchmark_rate",
"estimated_picture_read_cost_benchmark_rate",
"estimated_video_read_cost_benchmark_rate",
"estimated_picture_interaction_cost_benchmark_rate",
"estimated_video_interaction_cost_benchmark_rate",
"outbound_store_visit_median",
"outbound_store_visit_benchmark_rate",
"estimated_picture_store_visit_cost",
"estimated_video_store_visit_cost",
"estimated_picture_store_visit_cost_benchmark_rate",
"estimated_video_store_visit_cost_benchmark_rate",
"points"
],
"type": "object"
}
},
{
"description": "根据完整 user_id 获取小红书蒲公英创作者粉丝画像，包括年龄、性别、地域、城市、兴趣和设备品牌分布及数据日期。\n查询粉丝构成时使用；粉丝规模、增长、活跃、阅读和互动情况使用创作者粉丝汇总工具；创作者资料和报价使用创作者档案工具。\n使用平台默认统计范围，不支持指定日期；分布不保证完整，不能据此推算粉丝人数或补齐其他类别。\n成功返回画像字段和 points；成功调用扣减 20 积分，失败不扣费。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "xhs_pgy_get_creator_fans_profile",
"outputSchema": {
"additionalProperties": false,
"properties": {
"age_distribution": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"label": {
"description": "平台返回的分类标签；原样保留，不重新划分类别",
"type": "string"
},
"ratio": {
"description": "平台返回的占比，0.1 表示 10%；不按已返回分类重新归一化",
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"label",
"ratio"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "粉丝年龄分布；保留平台年龄区间标签，不推断端点含义；不保证完整，未知时为 null，明确为空时为 []"
},
"city_distribution": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"label": {
"description": "平台返回的分类标签；原样保留，不重新划分类别",
"type": "string"
},
"ratio": {
"description": "平台返回的占比，0.1 表示 10%；不按已返回分类重新归一化",
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"label",
"ratio"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "平台返回的粉丝城市分布；不保证列出全部城市，不重新归一化或补其他；未知时为 null，明确为空时为 []"
},
"data_date": {
"anyOf": [
{
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
{
"type": "null"
}
],
"description": "平台标注的数据日期（YYYY-MM-DD），不代表查询时间或统计起止范围；未知时为 null"
},
"device_distribution": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"display_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "设备品牌展示名称；未知时为 null"
},
"name": {
"description": "平台返回的设备品牌名称；不是设备型号",
"type": "string"
},
"ratio": {
"description": "平台返回的占比，0.1 表示 10%；不按已返回品牌重新归一化",
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"name",
"display_name",
"ratio"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "粉丝设备品牌分布；不保证列出全部品牌，不重新归一化或补其他；未知时为 null，明确为空时为 []"
},
"gender_distribution": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"female_ratio": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "女性粉丝占比，0.1 表示 10%；未知时为 null"
},
"male_ratio": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "男性粉丝占比，0.1 表示 10%；未知时为 null"
}
},
"required": [
"male_ratio",
"female_ratio"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "粉丝性别分布；不推算缺失占比，未知时为 null"
},
"interest_distribution": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"label": {
"description": "平台返回的分类标签；原样保留，不重新划分类别",
"type": "string"
},
"ratio": {
"description": "平台返回的占比，0.1 表示 10%；不按已返回分类重新归一化",
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"label",
"ratio"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "粉丝兴趣分布；不保证分类完整或互斥，不用占比之和推算其他兴趣；未知时为 null，明确为空时为 []"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"region_distribution": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"label": {
"description": "平台返回的分类标签；原样保留，不重新划分类别",
"type": "string"
},
"ratio": {
"description": "平台返回的占比，0.1 表示 10%；不按已返回分类重新归一化",
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"label",
"ratio"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "粉丝地域分布；标签可包含省份、中国、海外等，不统一视为省份；不保证完整，未知时为 null，明确为空时为 []"
},
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
}
},
"required": [
"user_id",
"data_date",
"age_distribution",
"gender_distribution",
"interest_distribution",
"region_distribution",
"city_distribution",
"device_distribution",
"points"
],
"type": "object"
}
},
{
"description": "根据完整 user_id 获取小红书蒲公英创作者粉丝总数、平台增长指标、活跃、阅读和互动粉丝人数及占比。\n查询粉丝规模和活跃情况时使用；年龄、性别、地域和兴趣等构成使用创作者粉丝画像工具。\n不支持指定日期或统计周期；增长周期及各统计窗口截止日期未提供，不能按查询日期推算，不承诺指定期间增长数据。\n成功直接返回汇总字段和 points；成功调用扣减 20 积分，失败不扣费。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "xhs_pgy_get_creator_fans_summary",
"outputSchema": {
"additionalProperties": false,
"properties": {
"active_follower_count_28d": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台 28 天统计窗口内的活跃粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；活跃判定按平台口径，不等同阅读或互动人数；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null"
},
"active_follower_ratio": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的活跃粉丝占比，0.419 表示 41.9%；保留平台精度，分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null"
},
"engaged_follower_count_30d": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台 30 天统计窗口内的互动粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；不是互动次数，具体互动构成按平台口径；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null"
},
"engaged_follower_ratio": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的互动粉丝占比，0.1 表示 10%；保留平台精度，0 不表示互动人数一定为 0；分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null"
},
"follower_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "蒲公英口径粉丝总数，单位人；未知时为 null"
},
"follower_growth_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台返回的粉丝增长数量；统计周期及是否扣除流失未明确，不可直接解释为近 30 天新增关注人数或净增人数；未知时为 null"
},
"follower_growth_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的粉丝增长率，0.1 表示 10%；不是粉丝构成占比，不限于 0–1。统计周期和计算基数未明确，不用返回人数复算；未知时为 null"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"read_follower_count_30d": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台 30 天统计窗口内的阅读粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；不是阅读次数；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null"
},
"read_follower_ratio": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的阅读粉丝占比，0.001 表示 0.1%；保留平台精度，分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null"
},
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
}
},
"required": [
"user_id",
"follower_count",
"follower_growth_count",
"follower_growth_rate",
"active_follower_count_28d",
"active_follower_ratio",
"engaged_follower_count_30d",
"engaged_follower_ratio",
"read_follower_count_30d",
"read_follower_ratio",
"points"
],
"type": "object"
}
},
{
"description": "根据完整 user_id 获取小红书蒲公英创作者曝光、阅读、互动中位数及预估成本的日期趋势和概览。\n观察指标随时间变化时使用；中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，不支持自选日期。合作口径包含进店指标，日常口径的进店字段为 null；输出回显口径，不能混用。\n返回指标不是每日新增量或累计总量，不可跨日期求和；可能缺少日期，不补零。\n成本估算口径见字段说明，不代表实际成交成本；按图文/视频拆分的成本及商业汇总使用商业概览工具，逐篇表现使用笔记表现工具。\n成功直接返回业务字段和 points；成功调用扣减 20 积分，失败不扣费。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"note_scope": {
"default": "daily",
"description": "笔记统计口径：日常笔记趋势选 daily（默认，不是按天汇总）；合作笔记或进店趋势选 cooperation。输出回显口径，不可混用；成本估算依据见各字段说明",
"enum": [
"daily",
"cooperation"
],
"type": "string"
},
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "xhs_pgy_get_creator_metrics_trend",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"date": {
"description": "平台指标日期（YYYY-MM-DD），不是查询日期；历史点的具体滚动窗口未明确",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"estimated_cpm": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "该日期对应的预估千次曝光成本，单位元/千次曝光；daily 结合报价及近30日日常和合作笔记的自然流量曝光中位数估算，cooperation 结合近30日合作笔记价格和曝光量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
},
"estimated_interaction_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "该日期对应的预估单次互动成本，单位元/互动；daily 结合报价及近30日日常和合作笔记的互动中位数估算，cooperation 结合近30日合作笔记价格和互动量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
},
"estimated_read_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "该日期对应的预估单次阅读成本，单位元/阅读；daily 结合报价及近30日日常和合作笔记的自然流量阅读中位数估算，cooperation 结合近30日合作笔记价格和阅读量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
},
"estimated_store_visit_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "该日期对应的预估进店成本，单位元/进店；结合近30日跨域（小红星/小红盟等）合作笔记价格与跨域进店UV计算，仅供参考，不是实际成交成本或ROI；仅 cooperation 返回，daily、零值或缺失时为 null；进店中位数为0时仍可能有有效成本"
},
"impression_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "该日期对应的笔记曝光量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
},
"interaction_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "该日期对应的笔记互动量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
},
"outbound_store_visit_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "该日期对应的合作笔记外溢进店量中位数，不是进店总人数、订单或成交量；仅 cooperation 返回，真实0保留，daily 或未知时为 null；不能与进店成本反算价格或人数"
},
"read_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "该日期对应的笔记阅读量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
}
},
"required": [
"date",
"impression_median",
"read_median",
"interaction_median",
"estimated_cpm",
"estimated_interaction_cost",
"estimated_read_cost",
"outbound_store_visit_median",
"estimated_store_visit_cost"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "平台返回的日期序列；中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，成本口径见各字段说明；可能缺少日期，不补零、不插值；未知时为 null，明确为空时为 []"
},
"note_scope": {
"description": "笔记统计口径：日常笔记趋势选 daily（默认，不是按天汇总）；合作笔记或进店趋势选 cooperation。输出回显口径，不可混用；成本估算依据见各字段说明",
"enum": [
"daily",
"cooperation"
],
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"summary": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"date": {
"description": "平台指标日期（YYYY-MM-DD），不是查询日期；历史点的具体滚动窗口未明确",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"estimated_cpm": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "该日期对应的预估千次曝光成本，单位元/千次曝光；daily 结合报价及近30日日常和合作笔记的自然流量曝光中位数估算，cooperation 结合近30日合作笔记价格和曝光量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
},
"estimated_interaction_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "该日期对应的预估单次互动成本，单位元/互动；daily 结合报价及近30日日常和合作笔记的互动中位数估算，cooperation 结合近30日合作笔记价格和互动量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
},
"estimated_read_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "该日期对应的预估单次阅读成本，单位元/阅读；daily 结合报价及近30日日常和合作笔记的自然流量阅读中位数估算，cooperation 结合近30日合作笔记价格和阅读量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
},
"estimated_store_visit_cost": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "该日期对应的预估进店成本，单位元/进店；结合近30日跨域（小红星/小红盟等）合作笔记价格与跨域进店UV计算，仅供参考，不是实际成交成本或ROI；仅 cooperation 返回，daily、零值或缺失时为 null；进店中位数为0时仍可能有有效成本"
},
"impression_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "该日期对应的笔记曝光量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
},
"interaction_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "该日期对应的笔记互动量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
},
"outbound_store_visit_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "该日期对应的合作笔记外溢进店量中位数，不是进店总人数、订单或成交量；仅 cooperation 返回，真实0保留，daily 或未知时为 null；不能与进店成本反算价格或人数"
},
"read_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "该日期对应的笔记阅读量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
}
},
"required": [
"date",
"impression_median",
"read_median",
"interaction_median",
"estimated_cpm",
"estimated_interaction_cost",
"estimated_read_cost",
"outbound_store_visit_median",
"estimated_store_visit_cost"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "平台提供的概览指标及其日期，不是趋势各点之和；缺失时为 null"
},
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
}
},
"required": [
"user_id",
"note_scope",
"summary",
"items",
"points"
],
"type": "object"
}
},
{
"description": "根据完整 user_id 获取小红书蒲公英创作者笔记表现，包括笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和笔记明细。\n查询日常或合作笔记表现及最近明细时使用；商业汇总与成本参考使用商业概览工具，资料和报价使用创作者档案工具。\n视频完播相关字段仅在 video_note_count 大于 0 时用于表现判断；图文 3 秒阅读率仅在统计范围内有图文笔记时用于表现判断；其他情况下 0 值不表示对应表现为 0%。\n固定近30日、图文＋视频、全流量，不支持自选日期或笔记类型；明细最多 15 篇，不是全量列表。仅 notes[] 内的 *_benchmark_rate 是相较于平台中位数的相对差异，允许负数和超过 1，不能当作排名比例；汇总层同名字段仍是平台返回的 0 到 1 对比值，计算方式未公开，不能混用。\n成功返回表现字段和 points；成功调用扣减 20 积分，失败不扣费。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"note_scope": {
"default": "daily",
"description": "笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径",
"enum": [
"daily",
"cooperation"
],
"type": "string"
},
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "xhs_pgy_get_creator_notes_performance",
"outputSchema": {
"additionalProperties": false,
"properties": {
"collect_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "笔记收藏量中位数；未知时为 null"
},
"comment_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "笔记评论量中位数；未知时为 null"
},
"content_tags": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"ratio": {
"description": "该内容标签占比，0.1 表示 10%",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"tag": {
"description": "笔记内容标签",
"type": "string"
}
},
"required": [
"tag",
"ratio"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "笔记内容标签分布；返回标签不保证覆盖全部内容，占比之和不保证为 1；不要自行归一化或补齐其他类别；未知时为 null，明确为空时为 []"
},
"hundred_like_ratio": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "获赞不少于 100 的笔记占比，0.1 表示 10%；未知时为 null"
},
"image_3s_view_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "图文笔记 3 秒阅读率，0.195 表示 19.5%；仅在统计范围内有图文笔记时用于表现判断；否则 0 值不表示 3 秒阅读率为 0%；未知时为 null"
},
"impression_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
},
"impression_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "笔记曝光量中位数；未知时为 null"
},
"interaction_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
},
"interaction_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台汇总口径的笔记互动量中位数；不保证与 notes[].interaction_count 的统计口径一致，不可直接用返回的笔记明细复算；未知时为 null"
},
"interaction_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的笔记互动率，0.195 表示 19.5%；本响应未提供可确认的计算分母和完整统计口径，不可用返回计数自行复算；未知时为 null"
},
"like_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "笔记点赞量中位数；未知时为 null"
},
"note_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "统计范围内笔记数；未知时为 null"
},
"note_scope": {
"description": "笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径",
"enum": [
"daily",
"cooperation"
],
"type": "string"
},
"notes": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"collect_benchmark_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null"
},
"collect_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "笔记收藏量；未知时为 null"
},
"impression_benchmark_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null"
},
"impression_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "笔记曝光量；未知时为 null"
},
"interaction_benchmark_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null"
},
"interaction_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "蒲公英口径综合互动量；具体构成以上游口径为准；未知时为 null"
},
"like_benchmark_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null"
},
"like_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "笔记点赞量；未知时为 null"
},
"note_id": {
"description": "小红书笔记 ID；必须为完整的 24 位小写十六进制 ID",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
},
"note_type": {
"anyOf": [
{
"enum": [
"image",
"video"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "笔记类型：image 表示图文，video 表示视频；未知时为 null"
},
"publish_date": {
"anyOf": [
{
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
{
"type": "null"
}
],
"description": "发布日期（YYYY-MM-DD）；上游未提供时为 null"
},
"read_benchmark_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null"
},
"read_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "笔记阅读量；未知时为 null"
},
"thumbnail_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "笔记缩略图地址；缺失时为 null"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "笔记标题；缺失时为 null"
}
},
"required": [
"note_id",
"publish_date",
"note_type",
"thumbnail_url",
"title",
"impression_count",
"impression_benchmark_rate",
"read_count",
"read_benchmark_rate",
"interaction_count",
"interaction_benchmark_rate",
"collect_count",
"like_count",
"collect_benchmark_rate",
"like_benchmark_rate"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "统计范围内最近发布的最多 15 篇笔记表现明细，不是全量列表；未知时为 null，明确为空时为 []"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"read_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
},
"read_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "笔记阅读量中位数；未知时为 null"
},
"share_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "笔记分享量中位数；未知时为 null"
},
"thousand_like_ratio": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "获赞不少于 1000 的笔记占比，0.1 表示 10%；未知时为 null"
},
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
},
"video_full_view_benchmark_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "平台返回的视频完播指标对比值，范围 0~1；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示表现为 0；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
},
"video_full_view_rate": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "视频完播率，0.195 表示 19.5%；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示完播率为 0%；未知时为 null"
},
"video_note_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "统计范围内视频笔记数；未知时为 null"
}
},
"required": [
"user_id",
"note_scope",
"note_count",
"video_note_count",
"hundred_like_ratio",
"thousand_like_ratio",
"content_tags",
"impression_median",
"impression_benchmark_rate",
"read_median",
"read_benchmark_rate",
"interaction_median",
"interaction_rate",
"interaction_benchmark_rate",
"like_median",
"collect_median",
"comment_median",
"share_median",
"video_full_view_rate",
"video_full_view_benchmark_rate",
"image_3s_view_rate",
"notes",
"points"
],
"type": "object"
}
},
{
"description": "根据完整 user_id 获取小红书蒲公英创作者档案、粉丝和商业笔记规模、合作行业、笔记阅读与互动中位数、内容分类、特征标签和创作者图文/视频合作报价。\n查询蒲公英创作者资料和报价时使用；普通账号资料使用用户信息工具。\n笔记表现使用创作者笔记表现工具；粉丝画像使用创作者粉丝画像工具；指标随日期变化使用创作者指标趋势工具。图文和视频报价单位为人民币元；零值不表示免费合作。\n成功返回档案字段和 points；成功调用扣减 20 积分，失败不扣费。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "xhs_pgy_get_creator_profile",
"outputSchema": {
"additionalProperties": false,
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "头像地址；缺失时为 null"
},
"business_note_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "商业笔记数；未知时为 null"
},
"content_categories": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"category": {
"description": "一级内容分类",
"type": "string"
},
"subcategories": {
"description": "二级内容分类；明确无二级分类时为空数组",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"category",
"subcategories"
],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "内容分类；未知时为 null，明确为空时为 []"
},
"cooperation_industries": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "合作行业名称列表；未知时为 null，明确为空时为 []"
},
"cooperation_note_count_30d": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "近 30 天合作笔记数；未知时为 null"
},
"feature_tags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "创作者特征标签；不是主页标签；未知时为 null，明确为空时为 []"
},
"follower_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "蒲公英口径粉丝数，单位人；未知时为 null"
},
"gender": {
"anyOf": [
{
"enum": [
"male",
"female"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "创作者性别：male 表示男，female 表示女；无法确认时为 null"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "创作者资料所在地，不是 IP 属地；缺失时为 null"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "创作者昵称；上游未提供时为 null"
},
"note_interaction_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "蒲公英口径笔记互动数中位数；具体互动构成以上游口径为准；未知时为 null"
},
"note_read_median": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "蒲公英口径笔记阅读数中位数；未知时为 null"
},
"picture_price": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "创作者图文笔记合作报价，单位：人民币元；未知时为 null，零值不表示免费合作"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"profile_url": {
"description": "由 user_id 生成的用户主页地址",
"type": "string"
},
"received_like_and_collect_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "获赞与收藏合计；不能拆算为独立点赞数或收藏数；未知时为 null"
},
"red_id": {
"description": "公开小红书号；缺失时为空字符串，不能作为 user_id 使用",
"type": "string"
},
"user_id": {
"description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。",
"pattern": "^[0-9a-f]{24}$",
"type": "string"
},
"video_price": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "创作者视频笔记合作报价，单位：人民币元；未知时为 null，零值不表示免费合作"
}
},
"required": [
"user_id",
"name",
"red_id",
"avatar_url",
"profile_url",
"location",
"gender",
"follower_count",
"business_note_count",
"cooperation_industries",
"cooperation_note_count_30d",
"note_read_median",
"received_like_and_collect_count",
"note_interaction_median",
"content_categories",
"feature_tags",
"picture_price",
"video_price",
"points"
],
"type": "object"
}
},
{
"description": "根据 note_id 获取小红书蒲公英单篇笔记商业增强详情，包括正文、图片或视频摘要、作者、曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。\n仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。\n用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。\n这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。\n查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
}
},
"required": [
"note_id"
],
"type": "object"
},
"name": "xhs_pgy_get_note_detail_by_note_id",
"outputSchema": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"description": "作者信息；详情页不返回小红书号",
"properties": {
"avatar_url": {
"description": "作者头像链接",
"minLength": 1,
"type": "string"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"description": "作者主页链接",
"minLength": 1,
"type": "string"
},
"user_id": {
"description": "作者 user_id",
"minLength": 1,
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"comment_count": {
"description": "评论数",
"type": "integer"
},
"content": {
"description": "笔记正文",
"type": "string"
},
"cover_image_url": {
"description": "统一封面图",
"minLength": 1,
"type": "string"
},
"exposure_count": {
"description": "笔记曝光量",
"type": "integer"
},
"image_items": {
"description": "静态图片明细；不包含 Live 图视频摘要，需要 Live 视频时使用普通笔记详情接口",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；没有时为 null"
},
"image_url": {
"description": "图片链接",
"minLength": 1,
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；没有时为 null"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"note_type": {
"description": "笔记类型；当前公开值固定为 image 或 video",
"enum": [
"image",
"video"
],
"type": "string"
},
"note_url": {
"description": "note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。",
"minLength": 1,
"type": "string"
},
"picture_price": {
"description": "创作者图文笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作",
"type": "number"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"publish_time": {
"description": "发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"read_count": {
"description": "笔记阅读量",
"type": "integer"
},
"share_count": {
"description": "分享数",
"type": "integer"
},
"title": {
"description": "蒲公英笔记标题",
"type": "string"
},
"update_time": {
"description": "更新时间，秒级 Unix 时间戳",
"type": "integer"
},
"video": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "视频摘要信息；视频笔记返回对象，图文笔记为 null"
},
"video_price": {
"description": "创作者视频笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作",
"type": "number"
}
},
"required": [
"note_id",
"note_url",
"title",
"note_type",
"content",
"cover_image_url",
"image_items",
"video",
"publish_time",
"update_time",
"exposure_count",
"read_count",
"like_count",
"collect_count",
"comment_count",
"share_count",
"author",
"picture_price",
"video_price",
"points"
],
"type": "object"
}
},
{
"description": "根据笔记链接、短链接或分享文案获取小红书蒲公英单篇笔记商业增强详情，包括曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。\n仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。\n用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。\n这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。\n查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"note_url": {
"description": "小红书笔记链接、短链接或分享文案。支持小红书笔记长链接、xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接，以及包含上述链接的完整分享文案。",
"type": "string"
}
},
"required": [
"note_url"
],
"type": "object"
},
"name": "xhs_pgy_get_note_detail_by_note_url",
"outputSchema": {
"additionalProperties": false,
"properties": {
"author": {
"additionalProperties": false,
"description": "作者信息；详情页不返回小红书号",
"properties": {
"avatar_url": {
"description": "作者头像链接",
"minLength": 1,
"type": "string"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"description": "作者主页链接",
"minLength": 1,
"type": "string"
},
"user_id": {
"description": "作者 user_id",
"minLength": 1,
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"comment_count": {
"description": "评论数",
"type": "integer"
},
"content": {
"description": "笔记正文",
"type": "string"
},
"cover_image_url": {
"description": "统一封面图",
"minLength": 1,
"type": "string"
},
"exposure_count": {
"description": "笔记曝光量",
"type": "integer"
},
"image_items": {
"description": "静态图片明细；不包含 Live 图视频摘要，需要 Live 视频时使用普通笔记详情接口",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；没有时为 null"
},
"image_url": {
"description": "图片链接",
"minLength": 1,
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；没有时为 null"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"note_type": {
"description": "笔记类型；当前公开值固定为 image 或 video",
"enum": [
"image",
"video"
],
"type": "string"
},
"note_url": {
"description": "note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。",
"minLength": 1,
"type": "string"
},
"picture_price": {
"description": "创作者图文笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作",
"type": "number"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"publish_time": {
"description": "发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"read_count": {
"description": "笔记阅读量",
"type": "integer"
},
"share_count": {
"description": "分享数",
"type": "integer"
},
"title": {
"description": "蒲公英笔记标题",
"type": "string"
},
"update_time": {
"description": "更新时间，秒级 Unix 时间戳",
"type": "integer"
},
"video": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "视频摘要信息；视频笔记返回对象，图文笔记为 null"
},
"video_price": {
"description": "创作者视频笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作",
"type": "number"
}
},
"required": [
"note_id",
"note_url",
"title",
"note_type",
"content",
"cover_image_url",
"image_items",
"video",
"publish_time",
"update_time",
"exposure_count",
"read_count",
"like_count",
"collect_count",
"comment_count",
"share_count",
"author",
"picture_price",
"video_price",
"points"
],
"type": "object"
}
},
{
"description": "按 keyword 搜索小红书图片，每项为一张图片及关联笔记，同一笔记可返回多张图片；page_token 可用于尝试下一页，不保证下一页有结果；结果按平台相关性排序，不承诺每条内容包含原词，不承诺完整召回；需要图文笔记而非单张图片时使用 xhs_search_notes(note_type=\"image\")；需要视频时使用 xhs_search_videos。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"keyword": {
"description": "搜索词，可传关键词或短语，例如露营、建筑、穿搭；不要传笔记链接、主页链接、note_id、user_id 或 page_token。",
"type": "string"
},
"page_token": {
"default": "",
"description": "媒体搜索分页令牌，首次请求留空；仅限同一工具、关键词和调用方，不得跨视频、图片或综合笔记搜索复用。将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。",
"type": "string"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "xhs_search_images",
"outputSchema": {
"properties": {
"items": {
"description": "图片列表；同一笔记的多张图片分别返回",
"items": {
"properties": {
"author": {
"description": "关联笔记作者",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"red_id": {
"description": "作者公开小红书号；没有小红书号时为空字符串",
"type": "string"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"red_id"
],
"type": "object"
},
"collect_count": {
"description": "关联笔记收藏数",
"type": "integer"
},
"comment_count": {
"description": "关联笔记评论数",
"type": "integer"
},
"height": {
"description": "图片高度，像素",
"type": "integer"
},
"image_id": {
"description": "图片标识，用于识别图片和按图片去重；不能作为笔记详情或评论工具的 note_id",
"type": "string"
},
"image_url": {
"description": "当前图片的查看链接",
"type": "string"
},
"like_count": {
"description": "关联笔记点赞数",
"type": "integer"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。同一笔记的多张图片共享 note_id；统计笔记数时按 note_id 去重，笔记互动数不要重复累加。",
"type": "string"
},
"note_url": {
"description": "note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。",
"type": "string"
},
"publish_time_text": {
"description": "平台显示的发布时间文本；没有时为空字符串",
"type": "string"
},
"share_count": {
"description": "关联笔记分享数",
"type": "integer"
},
"summary": {
"description": "关联笔记摘要；不是全文",
"type": "string"
},
"title": {
"description": "关联笔记标题",
"type": "string"
},
"width": {
"description": "图片宽度，像素",
"type": "integer"
}
},
"required": [
"image_id",
"image_url",
"width",
"height",
"note_id",
"note_url",
"title",
"summary",
"publish_time_text",
"like_count",
"collect_count",
"comment_count",
"share_count",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "可尝试下一页的不透明分页令牌，不保证下一页有结果；为空表示无法继续翻页。续页保持关键词和调用方不变，并将完整令牌原样传回图片搜索入口。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "搜索小红书 / Xiaohongshu / XHS / RedNote 相关笔记。用户需要按搜索词查找笔记时使用；查找图文笔记可设 note_type=\"image\"，查找单张图片用 xhs_search_images；视频默认搜索用 xhs_search_videos，需要排序或发布时间筛选时用本工具并设 note_type=\"video\"；已有笔记链接或 note_id 且需要单篇笔记详情时使用对应的详情工具；需要评论、回复或口播转文字时使用相应的 URL/ID 工具；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。\n返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"keyword": {
"description": "搜索词，可传关键词或短语，例如品牌名、话题、人物名、产品名或内容需求；不要传笔记链接、主页链接、note_id、user_id 或 page_token。",
"type": "string"
},
"note_type": {
"default": "all",
"description": "笔记类型筛选，可选：all（不限，默认）、image（图文）、video（视频）",
"enum": [
"all",
"image",
"video"
],
"type": "string"
},
"page_token": {
"default": "",
"description": "笔记搜索分页令牌。首次请求留空；继续翻页时传入上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一关键词、排序、笔记类型、发布时间范围和调用方的笔记搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。",
"type": "string"
},
"publish_time_range": {
"default": "all",
"description": "发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内）",
"enum": [
"all",
"day",
"week",
"half_year"
],
"type": "string"
},
"sort_type": {
"default": "general",
"description": "笔记搜索结果排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）、comment_count_descending（最多评论优先）、collect_count_descending（最多收藏优先）",
"enum": [
"general",
"time_descending",
"like_count_descending",
"comment_count_descending",
"collect_count_descending"
],
"type": "string"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "xhs_search_notes",
"outputSchema": {
"properties": {
"items": {
"description": "笔记搜索结果中的笔记列表，已过滤非笔记卡片与不可公开笔记；当前页过滤后可能为空数组",
"items": {
"properties": {
"author": {
"description": "作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"red_id": {
"description": "作者公开小红书号；没有小红书号时为空字符串",
"type": "string"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"red_id"
],
"type": "object"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"comment_count": {
"description": "评论数",
"type": "integer"
},
"cover_image_url": {
"description": "统一封面图",
"type": "string"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"note_type": {
"description": "笔记类型；当前公开值固定为 image 或 video",
"enum": [
"image",
"video"
],
"type": "string"
},
"note_url": {
"description": "note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。",
"type": "string"
},
"publish_time": {
"description": "发布时间，秒级 Unix 时间戳；0 表示未知，不应解释为实际发布日期",
"type": "integer"
},
"share_count": {
"description": "分享数",
"type": "integer"
},
"summary": {
"description": "笔记摘要；不是全文",
"type": "string"
},
"title": {
"description": "笔记标题",
"type": "string"
},
"update_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null"
},
"video": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频原始时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "视频摘要信息；视频笔记也可能为 null，表示未提供视频信息，不代表不是视频；图文为 null"
}
},
"required": [
"note_url",
"note_id",
"note_type",
"title",
"summary",
"cover_image_url",
"like_count",
"collect_count",
"comment_count",
"share_count",
"publish_time",
"update_time",
"video",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果或无法继续 token 翻页。继续笔记搜索时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 仅限同一工具、关键词和调用方；保持该工具支持的筛选条件不变，不得跨搜索工具复用。items 为空时不要单独据此判断结束。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "搜索小红书商品。用户需要按搜索词查找商品时使用；已有完整 sku_id（包括用户直接提供）时使用商品详情或商品评价工具，已有商品链接或分享文案时使用 xhs_get_product_detail_by_url；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"keyword": {
"description": "搜索词，可传商品名、品牌名、品类或商品需求；不要传商品链接、sku_id、spu_id 或 page_token。",
"type": "string"
},
"page_token": {
"default": "",
"description": "商品搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一商品关键词和调用方的商品搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "xhs_search_products",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "商品搜索结果列表",
"items": {
"additionalProperties": false,
"properties": {
"coupon_price": {
"description": "商品列表展示券后/成交价格，单位：元；没有独立券后金额时与 price 相同；不保证是最终实付价",
"type": "number"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "商品搜索展示描述；可能与标题重复或包含规格信息，不保证是完整详情描述；无法确认时为 null"
},
"image_url": {
"description": "商品图片链接",
"type": "string"
},
"price": {
"description": "商品列表展示销售价，单位：元；与商品详情的原价口径不同，不保证是最终实付价",
"type": "number"
},
"purchasable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "是否可购买；无法确认时为 null，不代表不可购买"
},
"sales_text": {
"description": "平台展示的商品销量文本；没有时为空字符串。带“+”的数量表示下限，不是精确销量；结合 sold_count 解读。",
"type": "string"
},
"shop_avatar_url": {
"description": "店铺头像链接",
"type": "string"
},
"shop_id": {
"description": "店铺 ID",
"type": "string"
},
"shop_name": {
"description": "店铺名称",
"type": "string"
},
"sku_id": {
"description": "商品 SKU ID；可用于商品详情接口，也可用于商品评价接口",
"type": "string"
},
"sold_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "已售数量；平台以带“+”的千级或万级文本展示时转换为对应整数下限（如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000），不是精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0。"
},
"spu_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "商品 SPU ID；不要作为商品详情接口入参，也不要作为商品评价接口入参；无法确认时为 null"
},
"stock_quantity": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "库存数量；无法确认时为 null，不代表库存为 0"
},
"title": {
"description": "商品标题",
"type": "string"
}
},
"required": [
"sku_id",
"spu_id",
"title",
"description",
"image_url",
"price",
"coupon_price",
"shop_id",
"shop_name",
"shop_avatar_url",
"stock_quantity",
"purchasable",
"sold_count",
"sales_text"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明商品搜索分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一商品关键词和调用方的商品搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据搜索词获取小红书候选搜索建议，用于补全搜索词；需要实际搜索笔记或商品时，分别使用 xhs_search_notes 或 xhs_search_products。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"keyword": {
"description": "搜索词，可传正在输入的关键词或短语；不要传笔记链接、主页链接、note_id、user_id 或分页令牌。",
"type": "string"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "xhs_search_suggestions",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "搜索建议条目列表",
"items": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "搜索建议补充说明；没有补充说明时为 null"
},
"search_target": {
"description": "采用该建议后应搜索的对象，例如 notes 或 goods",
"type": "string"
},
"text": {
"description": "搜索建议文本",
"type": "string"
}
},
"required": [
"text",
"search_target",
"description"
],
"type": "object"
},
"type": "array"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"points"
],
"type": "object"
}
},
{
"description": "按搜索词搜索小红书用户、账号或博主，支持分页；已有用户 ID 或主页链接时，使用用户资料工具。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"keyword": {
"description": "搜索词，可传昵称、账号名或小红书号；不要传主页链接、user_id 或分页令牌。",
"minLength": 1,
"type": "string"
},
"page_token": {
"default": "",
"description": "用户搜索分页令牌，首次请求留空；续页保持 keyword 不变，将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。",
"type": "string"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "xhs_search_users",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "搜索到的用户列表",
"items": {
"additionalProperties": false,
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "头像地址，无值时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"red_id": {
"description": "小红书号，无值时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 ID，可用于用户资料和用户笔记列表",
"type": "string"
},
"verified": {
"description": "是否官方认证",
"type": "boolean"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"red_id",
"verified"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页分页令牌，为空表示结束；续页保持 keyword 不变并完整原样传回。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "按 keyword 搜索小红书视频标签结果，每项为视频笔记，note_type 固定为 video，支持 page_token 翻页；结果按平台相关性排序，不承诺每条内容包含原词，不承诺完整召回；需要排序或发布时间筛选时使用 xhs_search_notes(note_type=\"video\")；本工具不接受这些筛选参数；需要图片时使用 xhs_search_images。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"keyword": {
"description": "搜索词，可传关键词或短语，例如露营、建筑、穿搭；不要传笔记链接、主页链接、note_id、user_id 或 page_token。",
"type": "string"
},
"page_token": {
"default": "",
"description": "媒体搜索分页令牌，首次请求留空；仅限同一工具、关键词和调用方，不得跨视频、图片或综合笔记搜索复用。将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。",
"type": "string"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "xhs_search_videos",
"outputSchema": {
"properties": {
"items": {
"description": "笔记搜索结果中的笔记列表，已过滤非笔记卡片与不可公开笔记；当前页过滤后可能为空数组",
"items": {
"properties": {
"author": {
"description": "作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；没有头像链接时为 null"
},
"name": {
"description": "作者名称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接；没有主页链接时为 null"
},
"red_id": {
"description": "作者公开小红书号；没有小红书号时为空字符串",
"type": "string"
},
"user_id": {
"description": "作者 user_id",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"red_id"
],
"type": "object"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"comment_count": {
"description": "评论数",
"type": "integer"
},
"cover_image_url": {
"description": "统一封面图",
"type": "string"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
},
"note_type": {
"description": "笔记类型；当前公开值固定为 image 或 video",
"enum": [
"image",
"video"
],
"type": "string"
},
"note_url": {
"description": "note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。",
"type": "string"
},
"publish_time": {
"description": "发布时间，秒级 Unix 时间戳；0 表示未知，不应解释为实际发布日期",
"type": "integer"
},
"share_count": {
"description": "分享数",
"type": "integer"
},
"summary": {
"description": "笔记摘要；不是全文",
"type": "string"
},
"title": {
"description": "笔记标题",
"type": "string"
},
"update_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null"
},
"video": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频原始时长，单位毫秒；没有时长时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；没有时为 null"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频链接；没有视频链接时为 null"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；没有时为 null"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "视频摘要信息；视频笔记也可能为 null，表示未提供视频信息，不代表不是视频；图文为 null"
}
},
"required": [
"note_url",
"note_id",
"note_type",
"title",
"summary",
"cover_image_url",
"like_count",
"collect_count",
"comment_count",
"share_count",
"publish_time",
"update_time",
"video",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果或无法继续 token 翻页。继续笔记搜索时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 仅限同一工具、关键词和调用方；保持该工具支持的筛选条件不变，不得跨搜索工具复用。items 为空时不要单独据此判断结束。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据小红书 note_id 提交视频笔记口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"note_id": {
"description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。",
"type": "string"
}
},
"required": [
"note_id"
],
"type": "object"
},
"name": "xhs_submit_video_speech_text_by_note_id",
"outputSchema": {
"additionalProperties": false,
"properties": {
"content_id": {
"description": "平台内容 ID。",
"type": "string"
},
"content_meta": {
"additionalProperties": false,
"description": "作品上下文信息，便于结合转写内容做口播分析。",
"properties": {
"author": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接。"
},
"name": {
"description": "作者昵称。",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接。"
},
"user_id": {
"description": "作者用户 ID。",
"type": "string"
}
},
"required": [
"user_id",
"name",
"profile_url",
"avatar_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作者信息。"
},
"content_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品链接。"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "平台作品原始描述、正文或配文。"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "音视频时长，单位毫秒。"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品标题；平台无标题时为 null。"
}
},
"required": [
"content_url",
"title",
"description",
"duration_ms",
"author"
],
"type": "object"
},
"content_type": {
"description": "内容类型。",
"type": "string"
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"description": "稳定错误码。",
"type": "string"
},
"message": {
"description": "面向用户的错误说明。",
"type": "string"
},
"retryable": {
"default": false,
"description": "是否可重试。",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
},
"is_terminal": {
"description": "是否已终态。",
"type": "boolean"
},
"job_id": {
"description": "任务 ID。",
"type": "string"
},
"message": {
"description": "面向用户/AI 的状态说明。",
"type": "string"
},
"next_action": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"description": "下一步查询工具可直接使用的参数。",
"type": "object"
},
"instruction": {
"description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
"type": "string"
},
"job_id": {
"description": "需要继续查询的 job_id。",
"type": "string"
},
"tool_name": {
"description": "下一步建议调用的查询工具。",
"type": "string"
}
},
"required": [
"tool_name",
"job_id",
"arguments",
"instruction"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "非终态时建议的下一步查询动作。"
},
"next_poll_after_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "建议下次查询前等待的秒数；非终态时可用。"
},
"platform": {
"description": "任务所属平台。",
"type": "string"
},
"source_id": {
"description": "任务来源 ID。",
"type": "string"
},
"status": {
"description": "任务状态。",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"expired"
],
"type": "string"
},
"transcript": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"segments": {
"description": "按时间顺序排列的分段结果。",
"items": {
"additionalProperties": false,
"properties": {
"end_ms": {
"description": "分段结束时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"start_ms": {
"description": "分段开始时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"text": {
"description": "分段文本。",
"type": "string"
}
},
"required": [
"start_ms",
"end_ms",
"text"
],
"type": "object"
},
"type": "array"
},
"text": {
"description": "完整口播转文字结果。",
"type": "string"
}
},
"required": [
"text",
"segments"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "成功时的口播转文字结果；非终态或失败时为 null。"
}
},
"required": [
"job_id",
"status",
"is_terminal",
"platform",
"content_id",
"source_id",
"content_type",
"content_meta",
"transcript",
"error",
"next_poll_after_seconds",
"next_action",
"message"
],
"type": "object"
}
},
{
"description": "根据小红书视频笔记链接、短链接或分享文案提交口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"note_url": {
"description": "小红书视频笔记链接、短链接或分享文案。",
"type": "string"
}
},
"required": [
"note_url"
],
"type": "object"
},
"name": "xhs_submit_video_speech_text_by_note_url",
"outputSchema": {
"additionalProperties": false,
"properties": {
"content_id": {
"description": "平台内容 ID。",
"type": "string"
},
"content_meta": {
"additionalProperties": false,
"description": "作品上下文信息，便于结合转写内容做口播分析。",
"properties": {
"author": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接。"
},
"name": {
"description": "作者昵称。",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接。"
},
"user_id": {
"description": "作者用户 ID。",
"type": "string"
}
},
"required": [
"user_id",
"name",
"profile_url",
"avatar_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作者信息。"
},
"content_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品链接。"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "平台作品原始描述、正文或配文。"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "音视频时长，单位毫秒。"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品标题；平台无标题时为 null。"
}
},
"required": [
"content_url",
"title",
"description",
"duration_ms",
"author"
],
"type": "object"
},
"content_type": {
"description": "内容类型。",
"type": "string"
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"description": "稳定错误码。",
"type": "string"
},
"message": {
"description": "面向用户的错误说明。",
"type": "string"
},
"retryable": {
"default": false,
"description": "是否可重试。",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
},
"is_terminal": {
"description": "是否已终态。",
"type": "boolean"
},
"job_id": {
"description": "任务 ID。",
"type": "string"
},
"message": {
"description": "面向用户/AI 的状态说明。",
"type": "string"
},
"next_action": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"description": "下一步查询工具可直接使用的参数。",
"type": "object"
},
"instruction": {
"description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
"type": "string"
},
"job_id": {
"description": "需要继续查询的 job_id。",
"type": "string"
},
"tool_name": {
"description": "下一步建议调用的查询工具。",
"type": "string"
}
},
"required": [
"tool_name",
"job_id",
"arguments",
"instruction"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "非终态时建议的下一步查询动作。"
},
"next_poll_after_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "建议下次查询前等待的秒数；非终态时可用。"
},
"platform": {
"description": "任务所属平台。",
"type": "string"
},
"source_id": {
"description": "任务来源 ID。",
"type": "string"
},
"status": {
"description": "任务状态。",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"expired"
],
"type": "string"
},
"transcript": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"segments": {
"description": "按时间顺序排列的分段结果。",
"items": {
"additionalProperties": false,
"properties": {
"end_ms": {
"description": "分段结束时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"start_ms": {
"description": "分段开始时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"text": {
"description": "分段文本。",
"type": "string"
}
},
"required": [
"start_ms",
"end_ms",
"text"
],
"type": "object"
},
"type": "array"
},
"text": {
"description": "完整口播转文字结果。",
"type": "string"
}
},
"required": [
"text",
"segments"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "成功时的口播转文字结果；非终态或失败时为 null。"
}
},
"required": [
"job_id",
"status",
"is_terminal",
"platform",
"content_id",
"source_id",
"content_type",
"content_meta",
"transcript",
"error",
"next_poll_after_seconds",
"next_action",
"message"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:3c15abe938ede19cefc3a0a5ddd92bef1f01a367e10d4eae0420cb19252c2575 | sha256sum