小红书专业号API不支持PHP直接调用，官方未开放第三方PHP接口；仅可通过创作者中心手动导出CSV或企业认证后接入开放平台有限接口，且需自行实现OAuth2鉴权、token刷新及合规请求逻辑。
小红书专业号 API 已不支持 PHP 直接调用
小红书官方从未开放过面向第三方（尤其是 PHP 后端）的公开专业号 API。所谓“调用 API 获取笔记数据与粉丝画像”，目前只有两种可行路径：一是通过小红书官方「创作者中心」后台导出 CSV（手动、有频次限制）；二是走「小红书开放平台」企业认证后的有限接口——但该平台仅对已签约的 MCN、品牌方或 SaaS 服务商开放，且不提供 PHP SDK，接口协议为 HTTPS + JSON，需自行封装请求逻辑。
直接用 file_get_contents 或 cURL 去抓取网页、模拟登录、解析 HTML 的方式，不仅违反小红书《用户协议》第 4.3 条，而且极易触发风控（IP 封禁、验证码、账号异常提示），实操中 99% 的 PHP 脚本会在 24 小时内失效。
小红书开放平台能拿到什么数据（PHP 可对接的前提）
即使你已完成企业认证并获得 client_id、client_secret 和 access_token，可用接口也极其有限：
-
/v1/notes/list：仅返回当前授权账号发布的笔记 ID、标题、发布时间、阅读量（非实时，T+1 延迟） -
/v1/insights/fans：仅提供粗粒度粉丝地域、性别、年龄段分布（如“25–30 岁占比 38%”），无具体画像字段（如职业、兴趣标签、设备型号） - 所有接口均要求
Authorization: Bearer {access_token}，且access_token有效期仅 2 小时，需自行实现刷新逻辑 - 调用频率上限为 60 次/分钟，超出即返回
429 Too Many Requests
PHP 实现 token 刷新与笔记列表请求的关键点
小红书开放平台不提供 PHP 示例，但其 OAuth2 流程是标准的。最容易出错的是 token 管理和签名生成：
立即学习“PHP免费学习笔记（深入）”；
- 必须持久化存储
refresh_token（首次授权后返回），它长期有效；而access_token每次调用前都得检查是否过期，不能硬编码或缓存在内存里 - 所有请求需在 Header 中带上
X-Request-ID（建议用uniqid()生成）和X-Timestamp（秒级时间戳），否则返回401 Unauthorized - 获取笔记列表时，
start_time和end_time必须是 Unix 时间戳，且跨度不能超过 30 天，否则返回400 Invalid parameter - 示例片段（仅核心逻辑）：
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://open.xiaohongshu.com/api/v1/notes/list?start_time=1717027200&end_time=1717632000&limit=20');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $access_token,
'X-Request-ID: ' . uniqid(),
'X-Timestamp: ' . time(),
'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
粉丝画像数据为什么 PHP 拿不到详细字段
小红书对粉丝数据做了严格脱敏处理，开放平台返回的 /v1/insights/fans 响应中：
- 没有 UID、手机号、昵称、头像链接等任何可识别个体的信息
- 地域只到「省」级别（如
"province": "广东省"），不返回城市或 IP 归属地 - 兴趣标签是平台预设的 12 个大类（如“美妆护肤”“母婴育儿”），无法获取用户主动关注的具体话题或笔记关键词
- 所有数值均为估算值，文档明确注明“数据存在约 ±15% 统计误差”
- 如果你看到某 PHP 库声称能“精准抓取粉丝手机号/浏览历史”，那一定是伪造响应或已失效的逆向工程产物，切勿用于生产环境
真正需要深度粉丝分析的场景，只能依赖小红书后台导出的 Excel 报表，再用 PHP 读取 CSV（fgetcsv）做本地处理——这是目前唯一稳定、合规、可长期运行的方式。
