- 云端点
- 用户信息（内部）
- 抖音相关接口
- 微博相关接口
- 小红书A类接口
- 小红书B类接口
- 小红书C类接口
- 小红书电商接口
- 哔哩哔哩相关接口
- 快手接口
- 淘宝接口
- 拼多多接口
- 推特接口
- 京东接口
- YouTube接口
- TikTok接口
- facebook接口
- wx搜一搜接口
- 蒲公英接口
- ins接口
- 头条接口
- 知乎接口
- 搜狐相关接口
- 百度相关接口
- 汽车之家相关接口
- 懂车帝相关接口
- 抖音直播间
- 抖音星图接口
- 星图_达人概览_内容表现_近15条视频(v17)
- 星图_达人概览_内容表现_播放量(V17)
- 星图_达人概览_内容表现_v2(批量)（v17）
- 星图_连接用户_连接用户画像_粉丝\铁粉画像(v17)
- 星图_连接用户_连接用户画像_观众画像(v17)
- 星图_达人主页基本信息(v17)
- 星图_达人报价(v17)
- 星图_连接用户_连接用户趋势_连接粉丝数(v17)
- 星图_达人_内容表现_数据概览(v17)
- 星图_达人_商业能力_商业能力分析(星图指数)(v17)
- 星图_达人_商业能力_性价比能力分析(v17)
- 达人_商业能力_合作能力分析(v17)
- 星图_达人_概览_代表作品(v17)
- 星图_热词分析_评论热词(v17)
- 星图_热词分析_内容热词(v17)
- 星图_达人内容表现内容类型分析(v17)
- 星图_达人连接用户连接用户分布(v17)
- 星图_转化能力分析(v17)
- 星图_达人_连接用户_连接用户来源(v17)
- 星图_商业能力_转化视频展示(v17)
- 星图_商单经验(v17)
- 星图_连接用户分布(v17)
- 星图_创作能力_全部视频(v17)
- 星图_达人搜索词相关视频数(v17)
- 星图_商业能 力_效果预估(v17)
- 星图_达人概览_种草价值(v17)
- 星图_创作能力_视频关键词(v17)
- 星图_达人简介(v17)
- 星图_达人昵称搜索(v17)
- 抖音电商接口
- 1688
- 速卖通
- 闲鱼接口
- reddit接口
- sephora接口
- ulta相关接口
- 唯品会相关接口
- 微店相关接口
- 苏宁相关接口
- ocr相关接口
- 亚马逊相关接口
- Google相关接口
小红书搜索用户(v4)
POST
/xhs/user_search
| 状态码 | 说明 |
|---|---|
| -1 | failed |
| 0 | success |
| 400 | 参数错误 |
| 1001 | 账户余额不足 |
| 1002 | 邮箱/手机号或密码错误 |
| 1003 | 请求频率超过上限 |
| 1004 | 邮箱或手机号已注册 |
| 1005 | 无效的 API Key |
| 1006 | 用户不存在 |
| 1007 | 登录凭证无效 |
| 1008 | 缺少 API Key |
| 1009 | 手机或邮箱已存在 |
| 1010 | 需要管理员授权 |
| 1011 | 原密码错误 |
| 1012 | 新密码不能与原密码相同 |
| 1013 | 手机号和uid不能都为空 |
| 1014 | 请填写验证码 |
| 1015 | 验证码错误或已过期 |
| 1016 | 登录失败次数过多，请输入验证码 |
| 1017 | 请填写手机号 |
| 1018 | 请填写邮箱 |
| 1019 | 接口不存在，请检查 |
| 1020 | 该接口未开通，请联系客服 |
| 5000 | 服务暂时不可用，请稍后重试 |
| 5003 | 网络连接失败，请稍后重试 |
| 6001 | 修改密码失败，请稍后重试 |
返回结果#
| 字段路径 | 中文说明 | 示例值 |
|---|---|---|
data.users[].id | 用户唯一ID | "5f74775f000000000100244b" |
data.users[].red_id | 小红书号 | "739385744" |
data.users[].name | 用户昵称 | "燕 云十六声" |
data.users[].desc | 用户简介 | "小红书号：739385744" |
data.users[].image | 头像URL | "https://sns-avatar-qc.xhscdn.com/..." |
data.users[].followed | 是否已关注 | false |
data.users[].self | 是否自己 | false |
data.users[].sub_title | 副标题（粉丝数） | "粉丝 3" |
data.users[].reason | 推荐理由 | "" |
data.users[].link | 跳转链接 | "xhsdiscover://1/user/user.xxx" |
data.users[].red_official_verify_type | 官方认证类型（0=未认证） | 0 |
data.users[].show_red_official_verify_icon | 是否显示认证图标 | false |
data.users[].red_official_verified | 是否官方认证 | false |
请求参数
Header 参数
Body 参数application/json
示例
{
"keyword": "燕云十六声",
"page": "1",
"fans_count": "1-6",
"user_type": "all"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.yddm.com/xhs/user_search' \
--header 'X-API-Key: {{X-API-Key}}' \
--header 'Content-Type: application/json' \
--data '{
"keyword": "燕云十六声",
"page": "1",
"fans_count": "1-6",
"user_type": "all"
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"code": 0,
"msg": "success",
"data": {
"cost": 100,
"balance": 8690900,
"users": [
{
"followed": false,
"red_official_verify_type": 0,
"self": false,
"sub_title": "粉丝 3",
"reason": "",
"id": "5f74775f000000000100244b",
"red_id": "739385744",
"show_red_official_verify_icon": false,
"red_official_verified": false,
"link": "xhsdiscover://1/user/user.5f74775f000000000100244b",
"name": "燕云十六声",
"desc": "小红书号：739385744",
"image": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31uvn7ppfjm605nrketfg892blvrbmug?imageView2/2/w/360/format/webp"
},
{
"id": "67081163000000001d0229f2",
"image": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31o3uml4al05g5po825hncafii10htbg?imageView2/2/w/360/format/webp",
"red_official_verify_type": 0,
"show_red_official_verify_icon": false,
"sub_title": "粉丝 4",
"reason": "",
"name": "燕云十六声",
"desc": "小红书号：94147320268",
"followed": false,
"red_id": "94147320268",
"red_official_verified": false,
"self": false,
"link": "xhsdiscover://1/user/user.67081163000000001d0229f2"
},
{
"image": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo321s9282nne005q3bsksjfsf40h0tb4g?imageView2/2/w/360/format/webp",
"followed": false,
"red_official_verify_type": 0,
"show_red_official_verify_icon": false,
"sub_title": "粉丝 6",
"name": "燕云十六声",
"red_id": "49672963542",
"red_official_verified": false,
"self": false,
"link": "xhsdiscover://1/user/user.686be539000000000d03f1e4",
"reason": "",
"id": "686be539000000000d03f1e4",
"desc": "小红书号：49672963542"
},
{
"red_official_verified": false,
"self": false,
"link": "xhsdiscover://1/user/user.696e2513000000000b039927",
"sub_title": "粉丝 5",
"desc": "小红书号：18620605093",
"image": "https://sns-avatar-qc.xhscdn.com/avatar/645b7f4a9262aeee795c99e7.jpg?imageView2/2/w/360/format/webp",
"followed": false,
"red_id": "18620605093",
"reason": "",
"id": "696e2513000000000b039927",
"name": "燕云十六声",
"red_official_verify_type": 0,
"show_red_official_verify_icon": false
},
{
"image": "https://sns-avatar-qc.xhscdn.com/avatar/645b800677c97ef1a2abc7e0.jpg?imageView2/2/w/360/format/webp",
"red_id": "18075649025",
"show_red_official_verify_icon": false,
"reason": "",
"name": "燕云十六声",
"desc": "小红书号：18075649025",
"followed": false,
"red_official_verify_type": 0,
"red_official_verified": false,
"self": false,
"link": "xhsdiscover://1/user/user.6607d3c5000000000b00db7c",
"sub_title": "粉丝 3",
"id": "6607d3c5000000000b00db7c"
},
{
"name": "燕云十六声",
"desc": "小红书号：26831728901",
"image": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo322be2j2f7a6g5q6ubjstopp928uvojg?imageView2/2/w/360/format/webp",
"red_id": "26831728901",
"red_official_verify_type": 0,
"show_red_official_verify_icon": false,
"red_official_verified": false,
"link": "xhsdiscover://1/user/user.68de5cf90000000037006729",
"id": "68de5cf90000000037006729",
"followed": false,
"self": false,
"sub_title": "粉丝 4",
"reason": ""
},
{
"self": false,
"image": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31f69kfufma005og8em3od6m2pnhta8g?imageView2/2/w/360/format/webp",
"followed": false,
"red_official_verify_type": 0,
"red_official_verified": false,
"link": "xhsdiscover://1/user/user.620875870000000021029ac2",
"sub_title": "粉丝 5",
"reason": "",
"id": "620875870000000021029ac2",
"name": "燕云十六声",
"desc": "小红书号：5201552277",
"red_id": "5201552277",
"show_red_official_verify_icon": false
},
{
"name": "燕云十六声",
"desc": "小红书号：95439476100",
"red_id": "95439476100",
"red_official_verify_type": 0,
"show_red_official_verify_icon": false,
"red_official_verified": false,
"self": false,
"reason": "",
"id": "67870d88000000000801f5d0",
"image": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31clkuhrm0m6g5ps71m423tegdrulj38?imageView2/2/w/360/format/webp",
"followed": false,
"link": "xhsdiscover://1/user/user.67870d88000000000801f5d0",
"sub_title": "粉丝 4"
},
{
"id": "6048c6ff0000000001008026",
"show_red_official_verify_icon": false,
"red_official_verified": false,
"self": false,
"link": "xhsdiscover://1/user/user.6048c6ff0000000001008026",
"reason": "",
"name": "燕云十六声",
"desc": "小红书号：9526483861",
"image": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31cm0df0a08005o28orvg90163ibujr8?imageView2/2/w/360/format/webp",
"followed": false,
"red_id": "9526483861",
"red_official_verify_type": 0,
"sub_title": "粉丝 6"
}
],
"filters": [
{
"group_show_type": 0,
"filter_tags": [
{
"origin_text": "",
"icon_url": "",
"icon_url_night": "",
"icon_tail_url": "",
"icon_tail_url_night": "",
"sub_filters_select_type": "",
"name": "不限",
"need_location_info": false,
"sub_filters": null,
"id": "all"
},
{
"name": "0-100",
"origin_text": "",
"icon_url_night": "",
"icon_tail_url_night": "",
"need_location_info": false,
"sub_filters": null,
"id": "0-100",
"icon_url": "",
"icon_tail_url": "",
"sub_filters_select_type": ""
},
{
"name": "100-1000",
"icon_tail_url_night": "",
"need_location_info": false,
"sub_filters_select_type": "",
"sub_filters": null,
"id": "100-1000",
"origin_text": "",
"icon_url": "",
"icon_url_night": "",
"icon_tail_url": ""
},
{
"name": "1000-1万",
"icon_url_night": "",
"sub_filters": null,
"id": "1000-10000",
"origin_text": "",
"icon_url": "",
"icon_tail_url": "",
"icon_tail_url_night": "",
"need_location_info": false,
"sub_filters_select_type": ""
},
{
"need_location_info": false,
"sub_filters_select_type": "",
"sub_filters": null,
"name": "1万-10万",
"origin_text": "",
"icon_tail_url": "",
"id": "10000-100000",
"icon_url": "",
"icon_url_night": "",
"icon_tail_url_night": ""
},
{
"icon_tail_url": "",
"need_location_info": false,
"sub_filters": null,
"id": "100000",
"origin_text": "",
"icon_url_night": "",
"icon_tail_url_night": "",
"sub_filters_select_type": "",
"name": "10万以上",
"icon_url": ""
}
],
"word_request_id": "b5b967bfeb9edd06a58dc8ac5865849c",
"invisible": true,
"type": "single",
"name": "粉丝数量",
"id": "fans_count"
},
{
"word_request_id": "3a9b1ee3522aa79f37f74d0c1e6c847f",
"invisible": true,
"type": "single",
"name": "用户类型",
"id": "user_type",
"group_show_type": 0,
"filter_tags": [
{
"name": "不限",
"origin_text": "",
"icon_url_night": "",
"icon_tail_url": "",
"id": "all",
"icon_url": "",
"icon_tail_url_night": "",
"need_location_info": false,
"sub_filters_select_type": "",
"sub_filters": null
},
{
"name": "普通用户",
"origin_text": "",
"icon_url_night": "",
"need_location_info": false,
"sub_filters_select_type": "",
"sub_filters": null,
"id": "regular_user",
"icon_url": "",
"icon_tail_url": "",
"icon_tail_url_night": ""
},
{
"sub_filters_select_type": "",
"icon_url": "",
"icon_tail_url_night": "",
"need_location_info": false,
"sub_filters": null,
"id": "personal_verification",
"name": "个人认证",
"origin_text": "",
"icon_url_night": "",
"icon_tail_url": ""
},
{
"icon_url": "",
"icon_tail_url": "",
"icon_tail_url_night": "",
"need_location_info": false,
"sub_filters": null,
"icon_url_night": "",
"sub_filters_select_type": "",
"id": "business_verification",
"name": "企业认证",
"origin_text": ""
}
]
}
],
"_type": "4"
}
}修改于 2026-09-24 07:10:36