{"platforms":["airbnb","alibaba1688","aliexpress","amazon","app_store","behance","bilibili","bluesky","booking","capterra","clutch","craigslist","crexi","dailymotion","deviantart","dewu","dice","discord","douban","douyin","dribbble","ebay","etsy","eventbrite","expedia","facebook","flickr","g2","gab","glassdoor","google_maps_reviews","google_play","indeed","instagram","iqiyi","jd","kuaishou","lemmy","linkedin","mastodon","medium","naukri","naver","netease_music","nextdoor","odysee","patreon","pinterest","producthunt","quora","realtor","reddit","rumble","seek","shopee","similarweb","snapchat","soundcloud","spotify","stepstone","substack","taobao","telegram","temu","thomasnet","threads","tiktok","toutiao","tripadvisor","trustpilot","truth_social","tumblr","twitch","twitter","upwork","vk","walmart","web","wechat_oa","weibo","xianyu","xiaohongshu","xing","yahoo_finance","yandex","yelp","youku","youtube","zhihu","zillow"],"capabilities":[{"platform":"xiaohongshu","action":"search","action_label":"关键词搜索","required_params":["keyword"],"mode":"sync","cost_credits":400,"price_cny":0.037187,"price_usd":0.005556,"optional_params":["content_type","date_range","page_token","sort"],"param_meanings":{"content_type":{"description":"按笔记类型筛选结果，具体类型与取值见当前接口的允许值列表。","allowed_values":["all","image","video"]},"sort":{"description":"search 的笔记列表排序：relevance 相关度、newest 最新、most_liked 点赞最多、most_commented 评论最多、most_collected 收藏最多；只使用当前接口列出的允许值。","allowed_values":["most_collected","most_commented","most_liked","newest","relevance"]},"date_range":{"description":"按笔记发布时间筛选：any_time 不限（不传时同此）、last_24_hours 最近 24 小时、last_7_days 最近 7 天、last_30_days 最近一个月、last_6_months 最近半年、last_1_year 最近一年。last_30_days 和 last_1_year 一页可能不足 20 条，一条都没有的页不收费；想要更满的页请配 sort=newest；这两档只能同步调用。翻页时保持同一个取值。","allowed_values":["any_time","last_1_year","last_24_hours","last_30_days","last_6_months","last_7_days"]},"keyword":{"description":"小红书笔记搜索词，传一个字符串，如 敏感肌防晒；搜索的是笔记内容，不是用户 ID。"},"page_token":{"description":"翻页游标（comments、sub_comments、search、user_posts、search_users、hashtag）：把上一次返回结果行里的 next_page_token 原样传入就拿下一页；不传从第一页开始。每页算一次调用，按次计费。"}},"returns_list":true,"available":true,"pagination":{"page_token":true,"token_ttl_hours":24},"page_size":20,"limit_ignored":true,"response_fields":["id","url","title","text","like_count","collect_count","comment_count","share_count","posted_at","image_url","author_name","author_id","avatar_url","author_url","is_video","next_page_token","video_url","duration_sec","duration_seconds","platform","poi_id","poi_name","images","is_goods_note","author_is_verified"],"platform_field_meanings":{"like_count":"点赞数。笔记、评论类结果是这条内容的点赞数；profile 里是该账号所有笔记累计获得的点赞数。null 表示不公开或这次没拿到，不等于 0。","collect_count":"收藏数。笔记类结果是这篇笔记被收藏的次数；profile 里是该账号笔记累计被收藏的次数。null 表示不公开或这次没拿到，不等于 0。","images":"图片链接列表。note、hashtag、search、user_posts 是笔记的全部图片（按原顺序）；评论类结果（comments、comments_batch、sub_comments）是评论所附的图片，含表情包贴图，没有图片时为空数组。null 表示这次没拿到这一项。","video_url":"视频播放地址（mp4），带签名、会过期，要留存请及时下载。图文笔记或这次没拿到时为 null。search/user_posts 行与 video 接口返回；note 详情不含（2026-10-14 起要地址请单独调用 video 接口）。","duration_sec":"视频时长，单位秒。图文笔记或这次没拿到时为 null。","is_video":"是否视频笔记。视频播放地址不在详情返回里（2026-10-14 起）：要地址请用同一篇笔记的 url 单独调用 video 接口，按次计费。","text":"笔记正文或评论内容。note、hashtag 返回笔记全文；search、user_posts 返回的笔记正文可能是截断的摘要（分别约 60 字、100 字以内），要全文用笔记 ID 调 note。","url":"该记录在小红书上的链接。search、note、profile、hashtag 返回的链接一般带访问令牌，未登录的浏览器也能打开（令牌有时效，过期后重新调用即可）；user_posts 返回的笔记链接不带令牌，在浏览器里打开需要令牌：用笔记 ID 调 note 能拿到可以打开的链接；search_users 返回的主页链接同样不带令牌，用 user_id 调 profile 拿能打开的链接。","author_url":"作者主页链接，不带访问令牌，未登录的浏览器打不开；用 author_id 调 profile 返回的 url 可以直接打开。","author_id":"作者的用户 ID，可直接传给 profile、user_posts。笔记类结果里是 24 位，与主页链接里的 ID 相同；评论类结果（comments、comments_batch、sub_comments）里多为 29 位的另一种写法。同一个人的两种写法不同，跨批次去重前先用 profile 换成它返回的 user_id。","next_page_token":"翻页游标：同一页每行的值相同，原样作为下一次请求的 page_token 就取下一页，其余参数保持不变；为空或没有这个字段表示没有下一页。能传 page_token 的是 search、user_posts、comments、sub_comments、search_users、hashtag；comments_batch 行上也带这一项，但它本身不收 page_token。","poi_id":"搜索结果卡片上标的地点 ID（search）；没标地点时没有这个字段。","poi_name":"搜索结果卡片上标的地点名称（search）。","author_is_verified":"作者是否官方认证（note、search）。","is_goods_note":"是否带货笔记（search、user_posts）。"}},{"platform":"xiaohongshu","action":"profile","action_label":"主页或对象详情","required_params":["user_id"],"mode":"sync","cost_credits":400,"price_cny":0.037187,"price_usd":0.005556,"param_meanings":{"user_id":{"description":"小红书用户主页 /user/profile/ 后面的用户 ID，或完整用户主页 URL；也可以直接用评论类结果里的 author_id。用于读取该账号资料或其发布的笔记，不是昵称。"}},"returns_list":false,"available":true,"response_fields":["user_id","nickname","red_id","url","bio","follower_count","following_count","like_collect_count","post_count","gender","ip_location","avatar_url","is_verified","tags","like_count","collect_count","real_name_info","verification_type","verification_text","location","platform"],"platform_field_meanings":{"red_id":"小红书号，用户自定义的可搜索 ID，区别于内部 user_id。","nickname":"用户昵称。","ip_location":"小红书展示的 IP 归属地（省份/国家），平台强制显示，非用户填写。user_posts 只有部分笔记带。","like_collect_count":"主页上的「获赞与收藏」：该账号笔记累计获得的点赞数与被收藏数之和。拆开的两个数见 like_count、collect_count。","like_count":"点赞数。笔记、评论类结果是这条内容的点赞数；profile 里是该账号所有笔记累计获得的点赞数。null 表示不公开或这次没拿到，不等于 0。","collect_count":"收藏数。笔记类结果是这篇笔记被收藏的次数；profile 里是该账号笔记累计被收藏的次数。null 表示不公开或这次没拿到，不等于 0。","url":"该记录在小红书上的链接。search、note、profile、hashtag 返回的链接一般带访问令牌，未登录的浏览器也能打开（令牌有时效，过期后重新调用即可）；user_posts 返回的笔记链接不带令牌，在浏览器里打开需要令牌：用笔记 ID 调 note 能拿到可以打开的链接；search_users 返回的主页链接同样不带令牌，用 user_id 调 profile 拿能打开的链接。","follower_count":"粉丝数。profile 里是精确值；search_users 里是从列表展示的「粉丝 1.2万」换算的近似值（1.2万 → 12000）。null 表示不公开或没认出来，不等于 0。","verification_type":"认证类型（search_users、profile）：individual 个人认证、business 企业认证、other 其他认证；未认证的账号没有这个字段。","gender":"用户性别，按主页展示值给出，可能为空。","tags":"标签列表：note 是笔记的话题标签；profile 是主页上展示的个人标签（如星座、地区），按页面原文。","real_name_info":"主页上展示的实名信息原文；没有时没有这个字段。","verification_text":"主页上的认证说明原文（profile）。"}},{"platform":"xiaohongshu","action":"user_posts","action_label":"用户内容","required_params":["user_id"],"mode":"sync","cost_credits":400,"price_cny":0.037187,"price_usd":0.005556,"optional_params":["page_token"],"param_meanings":{"user_id":{"description":"小红书用户主页 /user/profile/ 后面的用户 ID，或完整用户主页 URL；也可以直接用评论类结果里的 author_id。用于读取该账号资料或其发布的笔记，不是昵称。"},"page_token":{"description":"翻页游标（comments、sub_comments、search、user_posts、search_users、hashtag）：把上一次返回结果行里的 next_page_token 原样传入就拿下一页；不传从第一页开始。每页算一次调用，按次计费。"}},"returns_list":true,"available":true,"pagination":{"page_token":true,"token_ttl_hours":24},"page_size":20,"limit_ignored":true,"response_fields":["id","url","title","text","like_count","collect_count","comment_count","share_count","posted_at","image_url","author_name","author_id","avatar_url","author_url","is_video","next_page_token","video_url","duration_sec","duration_seconds","platform","images","is_goods_note","is_pinned","ip_location"],"platform_field_meanings":{"ip_location":"小红书展示的 IP 归属地（省份/国家），平台强制显示，非用户填写。user_posts 只有部分笔记带。","like_count":"点赞数。笔记、评论类结果是这条内容的点赞数；profile 里是该账号所有笔记累计获得的点赞数。null 表示不公开或这次没拿到，不等于 0。","collect_count":"收藏数。笔记类结果是这篇笔记被收藏的次数；profile 里是该账号笔记累计被收藏的次数。null 表示不公开或这次没拿到，不等于 0。","images":"图片链接列表。note、hashtag、search、user_posts 是笔记的全部图片（按原顺序）；评论类结果（comments、comments_batch、sub_comments）是评论所附的图片，含表情包贴图，没有图片时为空数组。null 表示这次没拿到这一项。","video_url":"视频播放地址（mp4），带签名、会过期，要留存请及时下载。图文笔记或这次没拿到时为 null。search/user_posts 行与 video 接口返回；note 详情不含（2026-10-14 起要地址请单独调用 video 接口）。","duration_sec":"视频时长，单位秒。图文笔记或这次没拿到时为 null。","is_video":"是否视频笔记。视频播放地址不在详情返回里（2026-10-14 起）：要地址请用同一篇笔记的 url 单独调用 video 接口，按次计费。","text":"笔记正文或评论内容。note、hashtag 返回笔记全文；search、user_posts 返回的笔记正文可能是截断的摘要（分别约 60 字、100 字以内），要全文用笔记 ID 调 note。","url":"该记录在小红书上的链接。search、note、profile、hashtag 返回的链接一般带访问令牌，未登录的浏览器也能打开（令牌有时效，过期后重新调用即可）；user_posts 返回的笔记链接不带令牌，在浏览器里打开需要令牌：用笔记 ID 调 note 能拿到可以打开的链接；search_users 返回的主页链接同样不带令牌，用 user_id 调 profile 拿能打开的链接。","author_url":"作者主页链接，不带访问令牌，未登录的浏览器打不开；用 author_id 调 profile 返回的 url 可以直接打开。","author_id":"作者的用户 ID，可直接传给 profile、user_posts。笔记类结果里是 24 位，与主页链接里的 ID 相同；评论类结果（comments、comments_batch、sub_comments）里多为 29 位的另一种写法。同一个人的两种写法不同，跨批次去重前先用 profile 换成它返回的 user_id。","next_page_token":"翻页游标：同一页每行的值相同，原样作为下一次请求的 page_token 就取下一页，其余参数保持不变；为空或没有这个字段表示没有下一页。能传 page_token 的是 search、user_posts、comments、sub_comments、search_users、hashtag；comments_batch 行上也带这一项，但它本身不收 page_token。","is_goods_note":"是否带货笔记（search、user_posts）。","is_pinned":"是否作者主页置顶的笔记（user_posts）；置顶笔记排在最前面，按发布时间分析时要排除。"}},{"platform":"xiaohongshu","action":"note","action_label":"笔记详情","required_params":["url"],"mode":"sync","cost_credits":400,"price_cny":0.037187,"price_usd":0.005556,"param_meanings":{"url":{"description":"小红书笔记完整链接，路径为 /explore/<笔记ID> 或 /discovery/item/<笔记ID>；优先使用近期搜索结果中的完整 URL，保留 xsec_token 等查询参数。sub_comments 还需同一笔记下的 comment_id。"}},"returns_list":false,"available":true,"response_fields":["id","url","title","text","like_count","collect_count","comment_count","share_count","posted_at","ip_location","author_name","author_id","is_video","avatar_url","author_url","platform","images","tags","topics","mentioned_users","lat","lng","has_goods","author_red_id","author_is_verified","language"],"platform_field_meanings":{"ip_location":"小红书展示的 IP 归属地（省份/国家），平台强制显示，非用户填写。user_posts 只有部分笔记带。","like_count":"点赞数。笔记、评论类结果是这条内容的点赞数；profile 里是该账号所有笔记累计获得的点赞数。null 表示不公开或这次没拿到，不等于 0。","collect_count":"收藏数。笔记类结果是这篇笔记被收藏的次数；profile 里是该账号笔记累计被收藏的次数。null 表示不公开或这次没拿到，不等于 0。","images":"图片链接列表。note、hashtag、search、user_posts 是笔记的全部图片（按原顺序）；评论类结果（comments、comments_batch、sub_comments）是评论所附的图片，含表情包贴图，没有图片时为空数组。null 表示这次没拿到这一项。","topics":"笔记的话题列表，每项是话题名称 name 和话题页 ID topic_id；topic_id 可以直接传给 hashtag 读这个话题下的笔记。没有话题或这次没拿到时没有这个字段。","is_video":"是否视频笔记。视频播放地址不在详情返回里（2026-10-14 起）：要地址请用同一篇笔记的 url 单独调用 video 接口，按次计费。","text":"笔记正文或评论内容。note、hashtag 返回笔记全文；search、user_posts 返回的笔记正文可能是截断的摘要（分别约 60 字、100 字以内），要全文用笔记 ID 调 note。","url":"该记录在小红书上的链接。search、note、profile、hashtag 返回的链接一般带访问令牌，未登录的浏览器也能打开（令牌有时效，过期后重新调用即可）；user_posts 返回的笔记链接不带令牌，在浏览器里打开需要令牌：用笔记 ID 调 note 能拿到可以打开的链接；search_users 返回的主页链接同样不带令牌，用 user_id 调 profile 拿能打开的链接。","author_url":"作者主页链接，不带访问令牌，未登录的浏览器打不开；用 author_id 调 profile 返回的 url 可以直接打开。","author_id":"作者的用户 ID，可直接传给 profile、user_posts。笔记类结果里是 24 位，与主页链接里的 ID 相同；评论类结果（comments、comments_batch、sub_comments）里多为 29 位的另一种写法。同一个人的两种写法不同，跨批次去重前先用 profile 换成它返回的 user_id。","tags":"标签列表：note 是笔记的话题标签；profile 是主页上展示的个人标签（如星座、地区），按页面原文。","author_red_id":"作者的小红书号：评论类结果（comments、comments_batch、sub_comments）是评论者的，note 是笔记作者的。","mentioned_users":"被 @ 的人：评论类结果是评论里 @ 的人，note 是笔记里 @ 的人；每项有 user_id、nickname。没有时没有这个字段。","lat":"笔记图片上带的定位纬度（note），按原值给出；没有定位时没有这个字段。","lng":"笔记图片上带的定位经度（note），与 lat 成对出现。","has_goods":"笔记是否挂了商品（note）。","author_is_verified":"作者是否官方认证（note、search）。"}},{"platform":"xiaohongshu","action":"video","action_label":"视频详情","required_params":["url"],"mode":"sync","cost_credits":400,"price_cny":0.037187,"price_usd":0.005556,"param_meanings":{"url":{"description":"小红书笔记完整链接，路径为 /explore/<笔记ID> 或 /discovery/item/<笔记ID>；优先使用近期搜索结果中的完整 URL，保留 xsec_token 等查询参数。sub_comments 还需同一笔记下的 comment_id。"}},"returns_list":false,"available":true,"response_fields":["id","url","video_url","duration_sec","duration_seconds","platform"],"platform_field_meanings":{"video_url":"视频播放地址（mp4），带签名、会过期，要留存请及时下载。图文笔记或这次没拿到时为 null。search/user_posts 行与 video 接口返回；note 详情不含（2026-10-14 起要地址请单独调用 video 接口）。","duration_sec":"视频时长，单位秒。图文笔记或这次没拿到时为 null。","url":"该记录在小红书上的链接。search、note、profile、hashtag 返回的链接一般带访问令牌，未登录的浏览器也能打开（令牌有时效，过期后重新调用即可）；user_posts 返回的笔记链接不带令牌，在浏览器里打开需要令牌：用笔记 ID 调 note 能拿到可以打开的链接；search_users 返回的主页链接同样不带令牌，用 user_id 调 profile 拿能打开的链接。"}},{"platform":"xiaohongshu","action":"comments","action_label":"评论","required_params":["url"],"mode":"sync","cost_credits":400,"price_cny":0.037187,"price_usd":0.005556,"optional_params":["page_token","sort"],"param_meanings":{"sort":{"description":"评论排序：default 平台默认排序（不传时同此）、newest 最新在前、most_liked 点赞最多在前。翻页时保持同一个取值（换了取值，上一页的 next_page_token 不再适用）。","allowed_values":["default","most_liked","newest"]},"url":{"description":"小红书笔记完整链接，路径为 /explore/<笔记ID> 或 /discovery/item/<笔记ID>；优先使用近期搜索结果中的完整 URL，保留 xsec_token 等查询参数。sub_comments 还需同一笔记下的 comment_id。"},"page_token":{"description":"翻页游标（comments、sub_comments、search、user_posts、search_users、hashtag）：把上一次返回结果行里的 next_page_token 原样传入就拿下一页；不传从第一页开始。每页算一次调用，按次计费。"}},"returns_list":true,"available":true,"pagination":{"page_token":true,"token_ttl_hours":24},"page_size":15,"limit_ignored":true,"response_fields":["id","text","like_count","posted_at","ip_location","author_name","author_id","sub_comment_count","note_id","note_url","next_page_token","images","is_author","author_avatar_url","author_red_id","author_is_ai_agent","mentioned_users","platform"],"platform_field_meanings":{"ip_location":"小红书展示的 IP 归属地（省份/国家），平台强制显示，非用户填写。user_posts 只有部分笔记带。","like_count":"点赞数。笔记、评论类结果是这条内容的点赞数；profile 里是该账号所有笔记累计获得的点赞数。null 表示不公开或这次没拿到，不等于 0。","sub_comment_count":"该条评论下的回复数（楼中楼）。","note_id":"笔记 ID，评论类能力用它回指所属笔记。","note_url":"所属笔记链接。","images":"图片链接列表。note、hashtag、search、user_posts 是笔记的全部图片（按原顺序）；评论类结果（comments、comments_batch、sub_comments）是评论所附的图片，含表情包贴图，没有图片时为空数组。null 表示这次没拿到这一项。","is_author":"这条评论是不是笔记作者本人写的。null 表示这次没拿到这一项，不等于 false。","text":"笔记正文或评论内容。note、hashtag 返回笔记全文；search、user_posts 返回的笔记正文可能是截断的摘要（分别约 60 字、100 字以内），要全文用笔记 ID 调 note。","author_id":"作者的用户 ID，可直接传给 profile、user_posts。笔记类结果里是 24 位，与主页链接里的 ID 相同；评论类结果（comments、comments_batch、sub_comments）里多为 29 位的另一种写法。同一个人的两种写法不同，跨批次去重前先用 profile 换成它返回的 user_id。","next_page_token":"翻页游标：同一页每行的值相同，原样作为下一次请求的 page_token 就取下一页，其余参数保持不变；为空或没有这个字段表示没有下一页。能传 page_token 的是 search、user_posts、comments、sub_comments、search_users、hashtag；comments_batch 行上也带这一项，但它本身不收 page_token。","author_avatar_url":"评论者的头像链接（comments、comments_batch、sub_comments）。","author_red_id":"作者的小红书号：评论类结果（comments、comments_batch、sub_comments）是评论者的，note 是笔记作者的。","author_is_ai_agent":"评论者是不是平台标记的 AI 账号；这次没拿到这一项时没有这个字段。","mentioned_users":"被 @ 的人：评论类结果是评论里 @ 的人，note 是笔记里 @ 的人；每项有 user_id、nickname。没有时没有这个字段。"}},{"platform":"xiaohongshu","action":"comments_batch","action_label":"多链接评论批量采集","required_params":["urls"],"mode":"sync","cost_credits":400,"price_cny":0.037187,"price_usd":0.005556,"optional_params":["sort"],"param_meanings":{"sort":{"description":"每篇笔记的评论排序：default 平台默认排序（不传时同此）、newest 最新在前、most_liked 点赞最多在前；对这次请求里的每篇笔记都生效。","allowed_values":["default","most_liked","newest"]},"urls":{"description":"comments_batch 的笔记链接数组，一次 1–20 条；每条都须包含笔记 ID 和有效的 xsec_token。按目标笔记数计费；部分目标失败时检查 partial / missed，不把未返回的目标当作没有评论。"}},"returns_list":true,"available":true,"page_size":15,"limit_ignored":true,"response_fields":["id","text","like_count","posted_at","ip_location","author_name","author_id","sub_comment_count","note_id","note_url","next_page_token","images","is_author","author_avatar_url","author_red_id","author_is_ai_agent","mentioned_users","platform"],"platform_field_meanings":{"ip_location":"小红书展示的 IP 归属地（省份/国家），平台强制显示，非用户填写。user_posts 只有部分笔记带。","like_count":"点赞数。笔记、评论类结果是这条内容的点赞数；profile 里是该账号所有笔记累计获得的点赞数。null 表示不公开或这次没拿到，不等于 0。","sub_comment_count":"该条评论下的回复数（楼中楼）。","note_id":"笔记 ID，评论类能力用它回指所属笔记。","note_url":"所属笔记链接。","images":"图片链接列表。note、hashtag、search、user_posts 是笔记的全部图片（按原顺序）；评论类结果（comments、comments_batch、sub_comments）是评论所附的图片，含表情包贴图，没有图片时为空数组。null 表示这次没拿到这一项。","is_author":"这条评论是不是笔记作者本人写的。null 表示这次没拿到这一项，不等于 false。","text":"笔记正文或评论内容。note、hashtag 返回笔记全文；search、user_posts 返回的笔记正文可能是截断的摘要（分别约 60 字、100 字以内），要全文用笔记 ID 调 note。","author_id":"作者的用户 ID，可直接传给 profile、user_posts。笔记类结果里是 24 位，与主页链接里的 ID 相同；评论类结果（comments、comments_batch、sub_comments）里多为 29 位的另一种写法。同一个人的两种写法不同，跨批次去重前先用 profile 换成它返回的 user_id。","next_page_token":"翻页游标：同一页每行的值相同，原样作为下一次请求的 page_token 就取下一页，其余参数保持不变；为空或没有这个字段表示没有下一页。能传 page_token 的是 search、user_posts、comments、sub_comments、search_users、hashtag；comments_batch 行上也带这一项，但它本身不收 page_token。","author_avatar_url":"评论者的头像链接（comments、comments_batch、sub_comments）。","author_red_id":"作者的小红书号：评论类结果（comments、comments_batch、sub_comments）是评论者的，note 是笔记作者的。","author_is_ai_agent":"评论者是不是平台标记的 AI 账号；这次没拿到这一项时没有这个字段。","mentioned_users":"被 @ 的人：评论类结果是评论里 @ 的人，note 是笔记里 @ 的人；每项有 user_id、nickname。没有时没有这个字段。"}},{"platform":"xiaohongshu","action":"sub_comments","action_label":"评论回复","required_params":["url","comment_id"],"mode":"sync","cost_credits":400,"price_cny":0.037187,"price_usd":0.005556,"optional_params":["page_token"],"param_meanings":{"url":{"description":"小红书笔记完整链接，路径为 /explore/<笔记ID> 或 /discovery/item/<笔记ID>；优先使用近期搜索结果中的完整 URL，保留 xsec_token 等查询参数。sub_comments 还需同一笔记下的 comment_id。"},"comment_id":{"description":"要展开回复的父评论 ID；从同一篇笔记的 comments 返回结果取得，并与 url 配对。不是笔记 ID，也不是评论作者 ID。"},"page_token":{"description":"翻页游标（comments、sub_comments、search、user_posts、search_users、hashtag）：把上一次返回结果行里的 next_page_token 原样传入就拿下一页；不传从第一页开始。每页算一次调用，按次计费。"}},"returns_list":true,"available":true,"pagination":{"page_token":true,"token_ttl_hours":24},"page_size":10,"limit_ignored":true,"response_fields":["id","text","like_count","posted_at","ip_location","author_name","author_id","reply_to_id","reply_to_author_name","reply_to_author_id","next_page_token","images","is_author","author_avatar_url","author_red_id","author_is_ai_agent","mentioned_users","platform"],"platform_field_meanings":{"ip_location":"小红书展示的 IP 归属地（省份/国家），平台强制显示，非用户填写。user_posts 只有部分笔记带。","like_count":"点赞数。笔记、评论类结果是这条内容的点赞数；profile 里是该账号所有笔记累计获得的点赞数。null 表示不公开或这次没拿到，不等于 0。","reply_to_id":"被回复的评论 ID，楼中楼里用来重建对话树。","images":"图片链接列表。note、hashtag、search、user_posts 是笔记的全部图片（按原顺序）；评论类结果（comments、comments_batch、sub_comments）是评论所附的图片，含表情包贴图，没有图片时为空数组。null 表示这次没拿到这一项。","is_author":"这条评论是不是笔记作者本人写的。null 表示这次没拿到这一项，不等于 false。","text":"笔记正文或评论内容。note、hashtag 返回笔记全文；search、user_posts 返回的笔记正文可能是截断的摘要（分别约 60 字、100 字以内），要全文用笔记 ID 调 note。","author_id":"作者的用户 ID，可直接传给 profile、user_posts。笔记类结果里是 24 位，与主页链接里的 ID 相同；评论类结果（comments、comments_batch、sub_comments）里多为 29 位的另一种写法。同一个人的两种写法不同，跨批次去重前先用 profile 换成它返回的 user_id。","next_page_token":"翻页游标：同一页每行的值相同，原样作为下一次请求的 page_token 就取下一页，其余参数保持不变；为空或没有这个字段表示没有下一页。能传 page_token 的是 search、user_posts、comments、sub_comments、search_users、hashtag；comments_batch 行上也带这一项，但它本身不收 page_token。","author_avatar_url":"评论者的头像链接（comments、comments_batch、sub_comments）。","author_red_id":"作者的小红书号：评论类结果（comments、comments_batch、sub_comments）是评论者的，note 是笔记作者的。","author_is_ai_agent":"评论者是不是平台标记的 AI 账号；这次没拿到这一项时没有这个字段。","mentioned_users":"被 @ 的人：评论类结果是评论里 @ 的人，note 是笔记里 @ 的人；每项有 user_id、nickname。没有时没有这个字段。","reply_to_author_name":"被回复人的昵称（sub_comments）。","reply_to_author_id":"被回复人的用户 ID（sub_comments），与 author_id 同为评论类结果里的写法。"}},{"platform":"xiaohongshu","action":"search_users","action_label":"用户搜索","required_params":["keyword"],"mode":"sync","cost_credits":400,"price_cny":0.037187,"price_usd":0.005556,"optional_params":["follower_range","page_token","user_type"],"param_meanings":{"keyword":{"description":"找账号的关键词，如 咖啡、品牌名或领域词；返回的是用户（博主、品牌号），不是笔记。"},"follower_range":{"description":"search_users 按粉丝量级筛选账号：under_100 不到 100、100_to_1k 100–1000、1k_to_10k 1000–1万、10k_to_100k 1万–10万、over_100k 10万以上；不传不限。","allowed_values":["100_to_1k","10k_to_100k","1k_to_10k","over_100k","under_100"]},"page_token":{"description":"翻页游标（comments、sub_comments、search、user_posts、search_users、hashtag）：把上一次返回结果行里的 next_page_token 原样传入就拿下一页；不传从第一页开始。每页算一次调用，按次计费。"},"user_type":{"description":"search_users 按账号类型筛选：general 普通用户、verified_individual 个人认证、business 企业认证；不传不限。","allowed_values":["business","general","verified_individual"]}},"returns_list":true,"available":true,"pagination":{"page_token":true,"token_ttl_hours":24},"page_size":20,"limit_ignored":true,"response_fields":["user_id","nickname","red_id","avatar_url","url","follower_count","is_verified","verification_type","next_page_token","platform"],"platform_field_meanings":{"red_id":"小红书号，用户自定义的可搜索 ID，区别于内部 user_id。","nickname":"用户昵称。","url":"该记录在小红书上的链接。search、note、profile、hashtag 返回的链接一般带访问令牌，未登录的浏览器也能打开（令牌有时效，过期后重新调用即可）；user_posts 返回的笔记链接不带令牌，在浏览器里打开需要令牌：用笔记 ID 调 note 能拿到可以打开的链接；search_users 返回的主页链接同样不带令牌，用 user_id 调 profile 拿能打开的链接。","follower_count":"粉丝数。profile 里是精确值；search_users 里是从列表展示的「粉丝 1.2万」换算的近似值（1.2万 → 12000）。null 表示不公开或没认出来，不等于 0。","verification_type":"认证类型（search_users、profile）：individual 个人认证、business 企业认证、other 其他认证；未认证的账号没有这个字段。","next_page_token":"翻页游标：同一页每行的值相同，原样作为下一次请求的 page_token 就取下一页，其余参数保持不变；为空或没有这个字段表示没有下一页。能传 page_token 的是 search、user_posts、comments、sub_comments、search_users、hashtag；comments_batch 行上也带这一项，但它本身不收 page_token。"}},{"platform":"xiaohongshu","action":"hashtag","action_label":"话题内容","required_params":["topic_id"],"mode":"sync","cost_credits":400,"price_cny":0.037187,"price_usd":0.005556,"optional_params":["page_token","sort"],"param_meanings":{"sort":{"description":"话题页笔记的排序：newest 最新在前（不传时同此）、popular 最热在前。翻页时保持同一个取值。","allowed_values":["newest","popular"]},"topic_id":{"description":"hashtag 的话题页 ID（24 位），或话题页链接（https://www.xiaohongshu.com/page/topics/<ID>、App 话题链接、小红书分享短链）。可以直接用 note 返回的 topics[].topic_id；注意不是笔记标签对象自己的 id，也不是话题名称。"},"page_token":{"description":"翻页游标（comments、sub_comments、search、user_posts、search_users、hashtag）：把上一次返回结果行里的 next_page_token 原样传入就拿下一页；不传从第一页开始。每页算一次调用，按次计费。"}},"returns_list":true,"available":true,"pagination":{"page_token":true,"token_ttl_hours":24},"page_size":20,"limit_ignored":true,"page_size_varies":true,"response_fields":["id","url","title","text","like_count","collect_count","comment_count","share_count","posted_at","image_url","author_name","author_id","avatar_url","author_url","is_video","next_page_token","video_url","duration_sec","duration_seconds","platform","images"],"platform_field_meanings":{"like_count":"点赞数。笔记、评论类结果是这条内容的点赞数；profile 里是该账号所有笔记累计获得的点赞数。null 表示不公开或这次没拿到，不等于 0。","collect_count":"收藏数。笔记类结果是这篇笔记被收藏的次数；profile 里是该账号笔记累计被收藏的次数。null 表示不公开或这次没拿到，不等于 0。","images":"图片链接列表。note、hashtag、search、user_posts 是笔记的全部图片（按原顺序）；评论类结果（comments、comments_batch、sub_comments）是评论所附的图片，含表情包贴图，没有图片时为空数组。null 表示这次没拿到这一项。","video_url":"视频播放地址（mp4），带签名、会过期，要留存请及时下载。图文笔记或这次没拿到时为 null。search/user_posts 行与 video 接口返回；note 详情不含（2026-10-14 起要地址请单独调用 video 接口）。","duration_sec":"视频时长，单位秒。图文笔记或这次没拿到时为 null。","is_video":"是否视频笔记。视频播放地址不在详情返回里（2026-10-14 起）：要地址请用同一篇笔记的 url 单独调用 video 接口，按次计费。","text":"笔记正文或评论内容。note、hashtag 返回笔记全文；search、user_posts 返回的笔记正文可能是截断的摘要（分别约 60 字、100 字以内），要全文用笔记 ID 调 note。","url":"该记录在小红书上的链接。search、note、profile、hashtag 返回的链接一般带访问令牌，未登录的浏览器也能打开（令牌有时效，过期后重新调用即可）；user_posts 返回的笔记链接不带令牌，在浏览器里打开需要令牌：用笔记 ID 调 note 能拿到可以打开的链接；search_users 返回的主页链接同样不带令牌，用 user_id 调 profile 拿能打开的链接。","author_url":"作者主页链接，不带访问令牌，未登录的浏览器打不开；用 author_id 调 profile 返回的 url 可以直接打开。","author_id":"作者的用户 ID，可直接传给 profile、user_posts。笔记类结果里是 24 位，与主页链接里的 ID 相同；评论类结果（comments、comments_batch、sub_comments）里多为 29 位的另一种写法。同一个人的两种写法不同，跨批次去重前先用 profile 换成它返回的 user_id。","next_page_token":"翻页游标：同一页每行的值相同，原样作为下一次请求的 page_token 就取下一页，其余参数保持不变；为空或没有这个字段表示没有下一页。能传 page_token 的是 search、user_posts、comments、sub_comments、search_users、hashtag；comments_batch 行上也带这一项，但它本身不收 page_token。"}},{"platform":"xiaohongshu","action":"trending","action_label":"热榜","required_params":[],"mode":"sync","cost_credits":400,"price_cny":0.037187,"price_usd":0.005556,"returns_list":true,"available":true,"default_limit":20,"max_limit":30,"response_fields":["id","url","title","author_name","is_video","image_url","platform"],"platform_field_meanings":{"is_video":"是否视频笔记。视频播放地址不在详情返回里（2026-10-14 起）：要地址请用同一篇笔记的 url 单独调用 video 接口，按次计费。","url":"该记录在小红书上的链接。search、note、profile、hashtag 返回的链接一般带访问令牌，未登录的浏览器也能打开（令牌有时效，过期后重新调用即可）；user_posts 返回的笔记链接不带令牌，在浏览器里打开需要令牌：用笔记 ID 调 note 能拿到可以打开的链接；search_users 返回的主页链接同样不带令牌，用 user_id 调 profile 拿能打开的链接。"}}],"async_mode":"Any capability can run async: send {\"mode\":\"async\"} in the POST /api/v1/social body to receive 202 + job_id immediately, then poll GET /api/v1/jobs/{job_id}. Use it for slow tasks or large limits instead of waiting on the 85s sync budget."}