小红书蒲公英 API - 粉丝整体新动态 (V1)
获取历史粉丝增长数据。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
token | query | string | 是 | 用户鉴权令牌。 |
userId | query | string | 是 | KOL的用户ID。 |
dateType | query | string | 否 | 数据的时间范围。 可用值： - DAY_30：最近 30 天- DAY_90：最近 90 天 |
increaseType | query | string | 否 | 增长数据类型。 可用值： - FANS_TOTAL: 总粉丝数- FANS_INCREASE: 新增粉丝数 |
代码示例
💡 环境说明
默认示例使用 https://api.justoneapi.com (prod-global)。中国大陆地区建议替换为 http://47.117.133.51:30015 (prod-cn) 以获得更好的访问体验。详见 环境选择。
bash
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/data/userId/fans_overall_new_history/v1?token=YOUR_API_KEY&userId=VALUE"text
我想使用 Just One API 提供的“粉丝整体新动态 (V1)”接口。
接口地址: https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/data/userId/fans_overall_new_history/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/xiaohongshu-pgy-apis/fans-overall-new-history-v1-zh.json
请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- userId (query): KOL的用户ID。 (必填)
- dateType (query): 数据的时间范围。
可用值：
- `DAY_30`：最近 30 天
- `DAY_90`：最近 90 天
- increaseType (query): 增长数据类型。
可用值：
- `FANS_TOTAL`: 总粉丝数
- `FANS_INCREASE`: 新增粉丝数
返回格式: JSON
响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为至少 60 秒。
3. 业务码说明：
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败，请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 余额不足
请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。python
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import requests
url = "https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/data/userId/fans_overall_new_history/v1?token=YOUR_API_KEY&userId=VALUE"
response = requests.get(url)
print(response.json())js
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/data/userId/fans_overall_new_history/v1?token=YOUR_API_KEY&userId=VALUE", {
method: "GET"
});
const data = await response.json();
console.log(data);java
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/data/userId/fans_overall_new_history/v1?token=YOUR_API_KEY&userId=VALUE"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/data/userId/fans_overall_new_history/v1?token=YOUR_API_KEY&userId=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/data/userId/fans_overall_new_history/v1?token=YOUR_API_KEY&userId=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;响应结果
json
{
"code": 0,
"data": {
"fansNumInc": 3941,
"fansNumIncRate": 0.0395,
"list": [
{
"num": 99743,
"dateKey": "2026-02-07"
},
{
"num": 99786,
"dateKey": "2026-02-08"
},
{
"num": 99823,
"dateKey": "2026-02-09"
},
{
"num": 99872,
"dateKey": "2026-02-10"
},
{
"num": 99914,
"dateKey": "2026-02-11"
},
{
"num": 99964,
"dateKey": "2026-02-12"
},
{
"num": 100011,
"dateKey": "2026-02-13"
},
{
"num": 100092,
"dateKey": "2026-02-14"
},
{
"num": 100206,
"dateKey": "2026-02-15"
},
{
"num": 100316,
"dateKey": "2026-02-16"
},
{
"num": 100503,
"dateKey": "2026-02-17"
},
{
"num": 100716,
"dateKey": "2026-02-18"
},
{
"num": 100846,
"dateKey": "2026-02-19"
},
{
"num": 101032,
"dateKey": "2026-02-20"
},
{
"num": 101642,
"dateKey": "2026-02-21"
},
{
"num": 101904,
"dateKey": "2026-02-22"
},
{
"num": 102136,
"dateKey": "2026-02-23"
},
{
"num": 102375,
"dateKey": "2026-02-24"
},
{
"num": 102582,
"dateKey": "2026-02-25"
},
{
"num": 102854,
"dateKey": "2026-02-26"
},
{
"num": 103076,
"dateKey": "2026-02-27"
},
{
"num": 103185,
"dateKey": "2026-02-28"
},
{
"num": 103282,
"dateKey": "2026-03-01"
},
{
"num": 103357,
"dateKey": "2026-03-02"
},
{
"num": 103415,
"dateKey": "2026-03-03"
},
{
"num": 103475,
"dateKey": "2026-03-04"
},
{
"num": 103505,
"dateKey": "2026-03-05"
},
{
"num": 103527,
"dateKey": "2026-03-06"
},
{
"num": 103590,
"dateKey": "2026-03-07"
},
{
"num": 103684,
"dateKey": "2026-03-08"
}
]
}
}💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。