小红书用户资料 API (V3)
GET
接口健康状态
24h 健康值
24h 平均耗时
最近检查时间
健康 可用 少量可用 基本不可用 暂无数据
健康
正在加载健康状态…
24 小时趋势
30 天趋势
通过用户ID或支持的个人主页URL获取小红书(RedNote)用户资料。用于支持创作者发现、账号研究,以及在进行相关内容分析前查看已知资料。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
token | query | string | 是 | - | 此 API 服务的访问令牌。 |
userId | query | string | 是 | - | 小红书用户ID或包含 /user/profile/ 的个人资料URL。 |
代码示例
bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/xiaohongshu/get-user/v3?token=YOUR_API_KEY&userId=VALUE'text
我想使用 JustOneAPI 提供的“用户资料 (V3)”接口。
接入地址: https://api.justoneapi.com。
接口路径: /api/xiaohongshu/get-user/v3?token=YOUR_API_KEY&userId=VALUE
接口地址: BASE_URL + /api/xiaohongshu/get-user/v3?token=YOUR_API_KEY&userId=VALUE
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/xiaohongshu-rednote/user-profile-v3-zh.json
请求参数说明:
- token (query): 此 API 服务的访问令牌。 (必填)
- userId (query): 小红书用户ID或包含 /user/profile/ 的个人资料URL。 (必填)
返回格式: 请根据实际 Content-Type 安全处理 JSON 或文本响应。
响应处理与错误码:
1. 需通过返回体中的 "code" 字段判断业务结果(code 为 0 表示成功)。
2. 超时建议:建议将请求超时时间设置为 120 秒;如果 120 秒偏长,请至少设置为 60 秒,但可能会有少量请求因超时而未接收到结果。
3. 业务码说明:
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败,请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 账户余额不足
- 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨,多个 TOKEN 仍共享同一个账户余额。
请帮我用我擅长的编程语言写一个脚本来调用这个接口,并处理返回结果。python
import requests
BASE_URL = "https://api.justoneapi.com" # 由 OpenAPI servers 提供
url = BASE_URL + "/api/xiaohongshu/get-user/v3?token=YOUR_API_KEY&userId=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
content_type = response.headers.get("content-type", "").lower()
if "json" in content_type:
try:
print(response.json())
except ValueError:
print(response.text)
elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
print(response.text)
else:
with open("response.bin", "wb") as output:
output.write(response.content)
print(f"Saved {len(response.content)} bytes to response.bin")js
const BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
const url = BASE_URL + "/api/xiaohongshu/get-user/v3?token=YOUR_API_KEY&userId=VALUE";
const response = await fetch(url, {
method: "GET",
signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
const contentType = (response.headers.get("content-type") || "").toLowerCase();
const mediaType = contentType.split(";", 1)[0].trim();
const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
if (textual) {
const responseText = new TextDecoder().decode(responseBytes);
let data = responseText;
if (contentType.includes("json")) {
try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
}
console.log(data);
} else {
console.log(`Received ${responseBytes.byteLength} binary bytes`);
}
}java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
public class Main {
public static void main(String[] args) throws Exception {
final String BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
final String url = BASE_URL + "/api/xiaohongshu/get-user/v3?token=YOUR_API_KEY&userId=VALUE";
HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
HttpRequest.Builder builder = HttpRequest.newBuilder()
.uri(URI.create(url))
.timeout(Duration.ofSeconds(120))
.method("GET", HttpRequest.BodyPublishers.noBody());
HttpRequest request = builder.build();
HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
System.out.println(response.statusCode());
String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
String mediaType = contentType.split(";", 2)[0].trim();
if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
System.out.println(new String(response.body(), StandardCharsets.UTF_8));
} else {
Files.write(Path.of("response.bin"), response.body());
System.out.println("Saved " + response.body().length + " bytes to response.bin");
}
}
}go
package main
import (
"fmt"
"io"
"os"
"strings"
"net/http"
"time"
)
const BASE_URL = "https://api.justoneapi.com" // 由 OpenAPI servers 提供
func main() {
client := &http.Client{Timeout: 120 * time.Second}
url := BASE_URL + "/api/xiaohongshu/get-user/v3?token=YOUR_API_KEY&userId=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
fmt.Println(resp.StatusCode)
bodyBytes, _ := io.ReadAll(resp.Body)
contentType := strings.ToLower(resp.Header.Get("Content-Type"))
mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
fmt.Println(string(bodyBytes))
} else {
os.WriteFile("response.bin", bodyBytes, 0600)
fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
}
}php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // 由 OpenAPI servers 提供
$url = $BASE_URL . '/api/xiaohongshu/get-user/v3?token=YOUR_API_KEY&userId=VALUE';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
echo $response;
} else {
file_put_contents('response.bin', $response);
echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}返回字段
业务成功时(code = 0)的主要返回字段。
账号基本资料10 个字段
data
响应包含小红书用户资料对象时返回的字段。
| 字段 | 类型 | 说明 |
|---|---|---|
userid | string | 该资料对应的小红书内部用户 ID。 |
red_id | string | 个人主页上展示的小红书号。 |
nickname | string | 用户主页的显示昵称。 |
desc | string | 小红书返回的个人简介。 |
gender | integer | 小红书返回的用户性别编码。 |
location | string | 个人主页上展示的所在地文本。 |
ip_location | string | 小红书返回的 IP 属地标识。 |
images | string | 用户头像的小尺寸图片链接。 |
imageb | string | 用户头像的大尺寸图片链接。 |
user_role_type | integer | 小红书账号角色类型编码。 |
粉丝与互动指标17 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
follows | integer | 小红书返回的该账号关注人数。 |
fans | integer | 平台返回的该账号粉丝人数。 |
liked | integer | 小红书返回的该账号获得的点赞数。 |
collected | integer | 小红书返回的该账号收到的收藏数。 |
ndiscovery | integer | 平台返回的该账号已发布笔记数。 |
atme_notes_num | integer | 平台返回的提及该账号的笔记数。 |
note_num_stat | object | 平台返回的已发布笔记数和收到的互动统计。 |
note_num_stat.posted | integer | 平台返回的已发布笔记数。 |
note_num_stat.liked | integer | 平台返回的获赞数。 |
note_num_stat.collected | integer | 平台返回的被收藏数。 |
interactions | array | 小红书在个人主页上展示的互动统计及标签。 |
interactions[] | object | 带展示标签的一项账号互动统计。 |
interactions[].type | string | 平台的统计项编码,例如 follows、fans 或 interaction。 |
interactions[].name | string | 平台的统计项展示标签。 |
interactions[].count | integer | 平台返回的该项统计数值。标签为「获赞与收藏」的互动项合计该账号获得的点赞数和收到的收藏数。 |
interactions[].is_private | boolean | 平台是否将该统计项标记为私密。 |
interactions[].toast | string | 与该统计项关联的展示提示,可能为空。 |
账号自己收藏的内容9 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
collected_notes_num | integer | 该账号自己收藏的笔记数。 |
collected_tags_num | integer | 该账号自己收藏的标签数。 |
collected_poi_num | integer | 该账号自己收藏的地点数。 |
collected_product_num | integer | 该账号自己收藏的商品数。 |
collected_brand_num | integer | 该账号自己收藏的品牌数。 |
collected_book_num | integer | 该账号自己收藏的图书数。 |
collected_movie_num | integer | 该账号自己收藏的电影数。 |
nboards | integer | 平台返回的该账号收藏专辑数。 |
default_collection_tab | string | 默认收藏标签页的标识。 |
认证与身份12 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
red_official_verified | boolean | 随用户资料返回的官方认证标记。 |
red_official_verify_type | integer | 平台返回的账号官方认证类型编码。 |
red_official_verify_content | string | 平台返回的账号官方认证展示文本。 |
red_official_verify_base_info | string | 以文本返回的官方认证基本信息。 |
red_official_verify_arrow | integer | 官方认证入口的箭头编码。 |
red_official_full_name | string | 账号官方认证关联的全名,有该值时返回。 |
show_red_official_verify_icon | boolean | 平台是否指示显示官方认证图标。 |
identity_label_migrated | boolean | 平台返回的主页身份标签迁移标记。 |
real_name_info | string | 平台返回的实名信息文本,可能为空。 |
real_name_deep_target | integer | 实名入口的平台目标编码。 |
identity_deeplink | string | 个人主页身份入口的小红书应用深链接。 |
sec_account_deeplink | string | 账号安全入口的小红书应用深链接。 |
品牌与店铺34 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
brand_account_info | object | 品牌主页信息,有相关信息时返回。 |
brand_account_info.account_type_name | string | 品牌账号类型标签。 |
brand_account_info.trade_type_first_name | string | 品牌账号的一级行业分类标签。 |
brand_account_info.topics | array | 品牌主页上展示的话题列表。 |
brand_account_info.topics[] | object | 品牌主页展示的一条话题。 |
brand_account_info.topics[].id | string | 该话题的 ID。 |
brand_account_info.topics[].name | string | 该话题的展示名称。 |
brand_account_info.topics[].link | string | 该话题关联的链接。 |
brand_account_info.topics[].sub_title | string | 该话题的展示副标题。 |
brand_account_info.conversions | array | 品牌主页的操作入口列表,有相关信息时返回。 |
brand_account_info.conversions[] | object | 品牌主页的一项操作入口。 |
brand_account_info.conversions[].id | string | 品牌操作入口的 ID。 |
brand_account_info.conversions[].name | string | 品牌操作入口的展示名称。 |
brand_account_info.conversions[].icon | string | 品牌操作入口的图标链接。 |
brand_account_info.conversions[].link | string | 品牌操作入口的目标链接。 |
brand_account_info.conversions[].is_shop | boolean | 该品牌操作是否标记为店铺入口。 |
brand_account_info.conversions[].is_red_shop | boolean | 该品牌操作是否标记为小红书店铺入口。 |
brand_account_info.conversions[].sub_title | string | 品牌操作入口的展示副标题。 |
buyer_info | object | 个人主页的买家相关标签页信息,有相关信息时返回。 |
buyer_info.tab_name | string | 买家相关标签页的展示名称。 |
buyer_info.choice_id | string | 买家主页信息中的选择项 ID。 |
buyer_info.extra_map | object | 买家相关主页入口的补充配置。 |
buyer_info.extra_map.curationGoodsSearch | string | 平台返回的精选商品搜索值,以字符串返回。 |
seller_info | object | 个人主页的卖家与店铺标签页信息,有相关信息时返回。 |
seller_info.store_id | string | 卖家主页关联的店铺 ID。 |
seller_info.tab_goods_name | string | 商品标签页的展示名称。 |
seller_info.tab_goods_api_version | integer | 平台返回的商品标签页版本号。 |
seller_info.tab_code_names | array | 卖家信息中返回的标签页编码列表。 |
seller_info.tab_code_names[] | string | 一个卖家标签页编码。 |
seller_info.is_tab_goods_first | boolean | 商品标签页是否排在首位。 |
seller_info.can_process_coupon | boolean | 平台是否指示支持处理优惠券。 |
seller_info.display_modules | object | 卖家主页的模块展示设置。 |
seller_info.display_modules.official | boolean | 卖家官方模块的展示标记。 |
customer_service_link | string | 客服入口链接,有该值时返回。 |
简介、头像与标签37 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
desc_at_users | array | 个人简介中提及的账号列表。 |
desc_at_users[] | object | 个人简介中提及的一个账号。 |
desc_at_users[].id | string | 被提及账号的小红书内部 ID。 |
desc_at_users[].nickname | string | 平台返回的被提及账号显示名称。 |
user_desc_info | object | 个人简介内容及展示信息。 |
user_desc_info.desc | string | 简介展示对象中的个人简介。 |
user_desc_info.desc_at_users | array | 简介展示对象中提及的账号列表。 |
user_desc_info.desc_at_users[] | object | 简介展示对象中提及的一个账号。 |
user_desc_info.desc_at_users[].user_id | string | 被提及账号的小红书内部 ID。 |
user_desc_info.desc_at_users[].nickname | string | 平台返回的被提及账号显示名称。 |
user_desc_info.desc_with_placeholder | string | 个人简介内容,可能包含平台展示使用的占位符。 |
user_desc_info.desc_keywords_switch | boolean | 是否启用简介关键词展示功能。 |
avatar_like_status | boolean | 平台在当前查看场景中是否将头像标记为已点赞。 |
avatar_handle_entry_list | array | 头像操作入口列表,可能为空。 |
avatar_pendant | object | 平台返回的头像装饰标记。 |
avatar_pendant.current_user_pendant | boolean | 当前头像是否带有平台装饰。 |
avatar_pendant.current_user_pet | boolean | 当前头像是否带有平台宠物装饰。 |
banner_info | object | 个人主页横幅信息。 |
banner_info.image | string | 个人主页横幅图片链接。 |
banner_info.bg_color | string | 个人主页横幅使用的背景色值。 |
banner_info.like_status | boolean | 平台在当前查看场景中是否将主页横幅标记为已点赞。 |
remark_name | string | 当前查看场景中的账号备注名或别名,可能为空。 |
level | object | 小红书返回的账号等级信息。 |
level.image | string | 账号等级的图标图片。 |
level.image_link | string | 账号等级图片关联的链接。 |
level.level_name | string | 平台返回的账号等级展示名称。 |
level.number | integer | 平台返回的账号等级数值。 |
red_club_info | object | 平台返回的小红书 Red Club 会员信息。 |
red_club_info.red_club | boolean | 小红书是否标记该账号为 Red Club 会员。 |
red_club_info.red_club_level | integer | Red Club 会员等级编码。 |
red_club_info.red_club_url | string | Red Club 入口关联的链接。 |
red_club_info.redclubscore | integer | 平台返回的该账号 Red Club 分数。 |
tags | array | 平台返回的个人主页标签和图标列表。 |
tags[] | object | 一项个人主页标签。 |
tags[].tag_type | string | 平台的标签类型编码。 |
tags[].icon | string | 标签图标链接,有该值时返回。 |
tags[].name | string | 标签展示名称,有该值时返回。 |
分享链接12 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
share_link | string | 用于分享该个人主页的链接。 |
share_info | object | 个人主页分享标题、说明文本及可能附带的店铺链接。 |
share_info.content | string | 分享个人主页时使用的说明文本。 |
share_info.title | string | 分享个人主页时使用的标题。 |
share_info.store_link | string | 分享信息中提供的店铺链接。 |
share_info_v2 | object | 随个人主页返回的另一组分享信息。 |
share_info_v2.content | string | 另一组分享信息中的说明文本。 |
share_info_v2.title | string | 另一组分享信息中的标题。 |
share_info_v2.ecom_title | string | 电商分享标题,有该值时返回。 |
share_info_v2.ecom_content | string | 电商分享说明,有该值时返回。 |
share_info_v2.ecom_share_link | string | 电商分享链接,有该值时返回。 |
community_rule_url | string | 小红书社区规则链接。 |
主页展示设置49 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
location_jump | boolean | 平台是否允许从个人主页打开所在地入口。 |
zhong_tong_bar_info | object | 个人主页操作栏信息。 |
zhong_tong_bar_info.conversions | array | 个人主页操作栏的入口列表。 |
zhong_tong_bar_info.conversions[] | object | 个人主页操作栏的一项入口。 |
zhong_tong_bar_info.conversions[].id | string | 操作栏入口的 ID。 |
zhong_tong_bar_info.conversions[].name | string | 操作栏入口的展示名称。 |
zhong_tong_bar_info.conversions[].sub_title | string | 操作栏入口的展示副标题。 |
zhong_tong_bar_info.conversions[].icon | string | 操作栏入口的图标链接。 |
zhong_tong_bar_info.conversions[].link | string | 操作栏入口的目标链接。 |
recommend_info | string | 平台返回的推荐展示文本,可能为空。 |
recommend_info_icon | string | 推荐展示文本关联的图标引用。 |
is_recommend_level_illegal | boolean | 平台返回的推荐等级限制标记。 |
show_extra_info_button | boolean | 个人主页界面是否展示补充信息按钮。 |
hula_tabs | object | 平台返回的个人主页标签页配置。 |
hula_tabs.andr_tab_padding_start | integer | Android 标签页布局起始侧的内边距值。 |
hula_tabs.andr_tab_padding_end | integer | Android 标签页布局结束侧的内边距值。 |
hula_tabs.all_show_tab_config | array | 个人主页已配置的标签页列表。 |
hula_tabs.all_show_tab_config[] | object | 个人主页标签页配置中的一项。 |
hula_tabs.all_show_tab_config[].tab_id | string | 个人主页标签页的标识。 |
hula_tabs.all_show_tab_config[].tab_name | string | 标签页的展示名称。 |
hula_tabs.all_show_tab_config[].tab_index_weight | integer | 平台返回的个人主页标签页排序权重。 |
hula_tabs.all_show_tab_config[].is_show_lock | boolean | 标签页是否应显示锁形图标。 |
tab_visible | object | 个人主页标签页的可见性标记。 |
tab_visible.note | boolean | 是否显示笔记标签页。 |
tab_visible.collect | boolean | 是否显示收藏标签页。 |
tab_visible.like | boolean | 是否显示点赞标签页。 |
tab_visible.atme | boolean | 是否显示提及标签页。 |
tab_visible.goods | boolean | 是否显示商品标签页。 |
tab_visible.hotel | boolean | 是否显示酒店标签页。 |
tab_visible.buyer | boolean | 是否显示买家标签页。 |
tab_visible.seed | boolean | 小红书是否显示 Seed 标签页。 |
tab_public | object | 个人主页指定区域的公开可见性标记。 |
tab_public.collection | boolean | 收藏区域是否标记为公开。 |
tab_public.collection_note | boolean | 用户收藏的笔记是否标记为公开。 |
tab_public.collection_board | boolean | 收藏专辑是否标记为公开。 |
tab_public.seed | boolean | Seed 标签页是否标记为公开。 |
user_widget_switch | boolean | 是否启用主页组件功能。 |
user_page_widgets_info | object | 平台返回的个人主页组件配置。 |
user_page_widgets_info.normal_widget_list | array | 个人主页已配置的通用组件列表。 |
user_page_widgets_info.normal_widget_list[] | object | 个人主页中的一个组件。 |
user_page_widgets_info.normal_widget_list[].widget_id | string | 组件的 ID。 |
user_page_widgets_info.normal_widget_list[].widget_name | string | 组件的展示名称。 |
user_page_widgets_info.normal_widget_list[].widget_size | integer | 平台返回的组件大小编码。 |
user_page_widgets_info.normal_widget_list[].template_id | string | 组件展示模板的 ID。 |
user_page_widgets_info.normal_widget_list[].render_type | integer | 平台的组件渲染类型编码。 |
user_page_widgets_info.normal_widget_list[].business_id | string | 组件关联对象的标识。 |
user_page_widgets_info.normal_widget_list[].business_type | string | 平台的组件关联对象类型编码。 |
user_page_widgets_info.normal_widget_list[].widget_data_content | string | 组件的序列化内容,以字符串返回。 |
user_page_widgets_info.shop_widget_list | array | 个人主页已配置的店铺组件列表,可能为空。 |
关系与可见性7 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
fstatus | string | 随个人主页返回的关注关系状态编码或标签。 |
blocking | boolean | 平台在当前响应场景中返回的屏蔽关系标记。 |
blocked | boolean | 平台在当前响应场景中返回的被屏蔽状态标记。 |
block_view_from_user | boolean | 平台返回的从该主页用户一侧发起查看时的限制标记。 |
block_view_to_user | boolean | 平台返回的查看该主页用户时的限制标记。 |
mute_view_to_user | boolean | 平台返回的面向该主页用户的查看静默标记。 |
is_login_user_pro_account | boolean | 平台当前查看场景中的专业账号标记。 |
响应信息4 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
result | object | 小红书用户资料内容中的处理结果信息。 |
result.success | boolean | 小红书用户资料内容中的成功标记。 |
result.code | integer | 小红书用户资料内容中的状态码。 |
result.message | string | 小红书用户资料内容中的状态消息。 |
响应示例
正在加载响应示例…