小红书蒲公英 API - 笔记评分 (V1)
获取笔记的性能数据。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
token | query | string | 是 | 用户鉴权令牌。 |
userId | query | string | 是 | KOL的用户ID。 |
business | query | string | 否 | 业务类型。 可用值： - DAILY_NOTE： 每日笔记- COOPERATE_NOTE： 协作笔记 |
noteType | query | string | 否 | 笔记类型。 可用值： - PHOTO_TEXT_AND_VIDEO: 照片和视频- PHOTO_TEXT: 照片和文本- VIDEO: 仅视频 |
dateType | query | string | 否 | 数据的时间范围。 可用值： - DAY_30：最近 30 天- DAY_90：最近 90 天 |
advertiseSwitch | query | string | 否 | 广告过滤器。 可用值： - ALL：所有笔记- ORGANIC_ONLY：仅限自然笔记 |
代码示例
💡 环境说明
默认示例使用 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/dataV3/notesRate/v1?token=YOUR_API_KEY&userId=VALUE"text
我想使用 Just One API 提供的“笔记评分 (V1)”接口。
接口地址: https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/dataV3/notesRate/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/xiaohongshu-pgy-apis/notes-rate-v1-zh.json
请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- userId (query): KOL的用户ID。 (必填)
- business (query): 业务类型。
可用值：
- `DAILY_NOTE`： 每日笔记
- `COOPERATE_NOTE`： 协作笔记
- noteType (query): 笔记类型。
可用值：
- `PHOTO_TEXT_AND_VIDEO`: 照片和视频
- `PHOTO_TEXT`: 照片和文本
- `VIDEO`: 仅视频
- dateType (query): 数据的时间范围。
可用值：
- `DAY_30`：最近 30 天
- `DAY_90`：最近 90 天
- advertiseSwitch (query): 广告过滤器。
可用值：
- `ALL`：所有笔记
- `ORGANIC_ONLY`：仅限自然笔记
返回格式: 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/dataV3/notesRate/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/dataV3/notesRate/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/dataV3/notesRate/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/dataV3/notesRate/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/dataV3/notesRate/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": {
"noteNumber": 64,
"videoNoteNumber": 64,
"hundredLikePercent": "73.4",
"thousandLikePercent": "20.3",
"noteType": [
{
"contentTag": "母婴",
"percent": "98.4"
},
{
"contentTag": "情感",
"percent": "1.6"
}
],
"tradeNames": null,
"impMedian": 36104,
"impMedianBeyondRate": "37.4",
"readMedian": 18524,
"readMedianBeyondRate": "56.5",
"interactionMedian": 276,
"interactionRate": "0.9",
"interactionBeyondRate": "30.2",
"likeMedian": 231,
"collectMedian": 33,
"commentMedian": 12,
"shareMedian": 11,
"videoFullViewRate": "32.7",
"videoFullViewBeyondRate": "92.3",
"picture3sViewRate": "0.0",
"notes": [
{
"noteId": "699ad6bb000000000a03cd8b",
"date": null,
"publishTime": "2026-02-22",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31ssssef958e05pcp0b0ogdgrbp807sg?imageView2/2/w/540/format/jpg/q/75",
"title": "团团：扳回一局哈哈",
"canJump": true,
"impNum": 44535,
"impBeyondRate": 0.233,
"readNum": 35553,
"readBeyondRate": 0.919,
"interactionNum": 144,
"interactionBeyondRate": -0.535,
"collectNum": 17,
"likeNum": 112,
"collectBeyondRate": -0.484,
"likeBeyondRate": -0.515
},
{
"noteId": "699c21bb000000000a02f043",
"date": null,
"publishTime": "2026-02-23",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31su58vpf588g5pcp0b0ogdgrrpotcao?imageView2/2/w/540/format/jpg/q/75",
"title": "一个字也不认识但记得每一片地图算文盲吗😂",
"canJump": true,
"impNum": 11919,
"impBeyondRate": -0.669,
"readNum": 5332,
"readBeyondRate": -0.712,
"interactionNum": 184,
"interactionBeyondRate": -0.406,
"collectNum": 30,
"likeNum": 128,
"collectBeyondRate": -0.09,
"likeBeyondRate": -0.445
},
{
"noteId": "699d7978000000000b012465",
"date": null,
"publishTime": "2026-02-24",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31svf9dpblce05pcp0b0ogdgrlhbida8?imageView2/2/w/540/format/jpg/q/75",
"title": "要了一上午也不给我，于是只能“偷梁换柱”",
"canJump": true,
"impNum": 201387,
"impBeyondRate": 4.577,
"readNum": 166710,
"readBeyondRate": 7.999,
"interactionNum": 926,
"interactionBeyondRate": 1.987,
"collectNum": 101,
"likeNum": 696,
"collectBeyondRate": 2.06,
"likeBeyondRate": 2.012
},
{
"noteId": "699ec9290000000022022354",
"date": null,
"publishTime": "2026-02-25",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31t0o87l45ce05pcp0b0ogdgrbh1ovvo?imageView2/2/w/540/format/jpg/q/75",
"title": "后续，最终的解决方案双方表示都很满意",
"canJump": true,
"impNum": 494095,
"impBeyondRate": 12.685,
"readNum": 492234,
"readBeyondRate": 25.572,
"interactionNum": 4636,
"interactionBeyondRate": 13.954,
"collectNum": 707,
"likeNum": 3079,
"collectBeyondRate": 20.424,
"likeBeyondRate": 12.329
},
{
"noteId": "69a01aff0000000022030d4a",
"date": null,
"publishTime": "2026-02-26",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31t21gdhnle005pcp0b0ogdgrk0bgnk0?imageView2/2/w/540/format/jpg/q/75",
"title": "团团：真是个稳赚不赔的好买卖🤭",
"canJump": true,
"impNum": 123928,
"impBeyondRate": 2.432,
"readNum": 116616,
"readBeyondRate": 5.295,
"interactionNum": 2289,
"interactionBeyondRate": 6.383,
"collectNum": 1033,
"likeNum": 1086,
"collectBeyondRate": 30.303,
"likeBeyondRate": 3.701
},
{
"noteId": "69a17011000000002602c2d4",
"date": null,
"publishTime": "2026-02-27",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g00831t3b4i80l6005pcp0b0ogdgrbrcehdo?imageView2/2/w/540/format/jpg/q/75",
"title": "凭实力把自己养活😂",
"canJump": true,
"impNum": 19820,
"impBeyondRate": -0.451,
"readNum": 13588,
"readBeyondRate": -0.266,
"interactionNum": 200,
"interactionBeyondRate": -0.354,
"collectNum": 28,
"likeNum": 159,
"collectBeyondRate": -0.151,
"likeBeyondRate": -0.311
},
{
"noteId": "69a2bd0b0000000026032e0d",
"date": null,
"publishTime": "2026-02-28",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31t4jpf8d5efg5pcp0b0ogdgr5hiae9o?imageView2/2/w/540/format/jpg/q/75",
"title": "爸爸：这个忙不敢帮 根本赔不起",
"canJump": true,
"impNum": 20565,
"impBeyondRate": -0.43,
"readNum": 6570,
"readBeyondRate": -0.645,
"interactionNum": 128,
"interactionBeyondRate": -0.587,
"collectNum": 17,
"likeNum": 89,
"collectBeyondRate": -0.484,
"likeBeyondRate": -0.614
},
{
"noteId": "69a415610000000026033bb5",
"date": null,
"publishTime": "2026-03-01",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31t5tqedd5a705pcp0b0ogdgrgj8otdo?imageView2/2/w/540/format/jpg/q/75",
"title": "父母恩爱才是对孩子最好的教育！",
"canJump": true,
"impNum": 13504,
"impBeyondRate": -0.625,
"readNum": 7442,
"readBeyondRate": -0.598,
"interactionNum": 241,
"interactionBeyondRate": -0.222,
"collectNum": 16,
"likeNum": 191,
"collectBeyondRate": -0.515,
"likeBeyondRate": -0.173
},
{
"noteId": "69a55e120000000026030063",
"date": null,
"publishTime": "2026-03-02",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g00831t75udvh6e005pcp0b0ogdgr1e17nlg?imageView2/2/w/540/format/jpg/q/75",
"title": "所以说男孩子一定要多跟爸爸接触！",
"canJump": true,
"impNum": 93924,
"impBeyondRate": 1.601,
"readNum": 85581,
"readBeyondRate": 3.62,
"interactionNum": 1244,
"interactionBeyondRate": 3.012,
"collectNum": 90,
"likeNum": 1082,
"collectBeyondRate": 1.727,
"likeBeyondRate": 3.683
},
{
"noteId": "69a6bccd00000000220336c3",
"date": null,
"publishTime": "2026-03-03",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31t8gnf9b58e05pcp0b0ogdgrdkc4g5o?imageView2/2/w/540/format/jpg/q/75",
"title": "姐姐：我要验牌！ 团团：我只关心吃",
"canJump": true,
"impNum": 96399,
"impBeyondRate": 1.67,
"readNum": 91927,
"readBeyondRate": 3.962,
"interactionNum": 489,
"interactionBeyondRate": 0.577,
"collectNum": 60,
"likeNum": 408,
"collectBeyondRate": 0.818,
"likeBeyondRate": 0.766
},
{
"noteId": "69a806660000000022022d42",
"date": null,
"publishTime": "2026-03-04",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g00831t9ovb3nme005pcp0b0ogdgrb5ni998?imageView2/2/w/540/format/jpg/q/75",
"title": "家里最高规格的洗脚服务，儿子我好羡慕你😓",
"canJump": true,
"impNum": 12555,
"impBeyondRate": -0.652,
"readNum": 3857,
"readBeyondRate": -0.791,
"interactionNum": 131,
"interactionBeyondRate": -0.577,
"collectNum": 19,
"likeNum": 87,
"collectBeyondRate": -0.424,
"likeBeyondRate": -0.623
},
{
"noteId": "69a9581300000000260315e2",
"date": null,
"publishTime": "2026-03-05",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g00831tb26t83le005pcp0b0ogdgrup8ekno?imageView2/2/w/540/format/jpg/q/75",
"title": "情绪这块把控的刚刚好😂",
"canJump": true,
"impNum": 96740,
"impBeyondRate": 1.679,
"readNum": 92987,
"readBeyondRate": 4.019,
"interactionNum": 693,
"interactionBeyondRate": 1.235,
"collectNum": 71,
"likeNum": 566,
"collectBeyondRate": 1.151,
"likeBeyondRate": 1.45
},
{
"noteId": "69aab0360000000023039c1d",
"date": null,
"publishTime": "2026-03-06",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g00831tcc7a4c56005pcp0b0ogdgr5cbo97g?imageView2/2/w/540/format/jpg/q/75",
"title": "对孩子最好的爱的教育就是爸爸爱妈妈",
"canJump": true,
"impNum": 33262,
"impBeyondRate": -0.078,
"readNum": 29051,
"readBeyondRate": 0.568,
"interactionNum": 817,
"interactionBeyondRate": 1.635,
"collectNum": 87,
"likeNum": 613,
"collectBeyondRate": 1.636,
"likeBeyondRate": 1.653
},
{
"noteId": "69abf843000000002603c375",
"date": null,
"publishTime": "2026-03-07",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31tdk8qj46ee05pcp0b0ogdgr5fbfslg?imageView2/2/w/540/format/jpg/q/75",
"title": "你家娃也是一关灯就要喝水吗😂",
"canJump": true,
"impNum": 238286,
"impBeyondRate": 5.599,
"readNum": 131324,
"readBeyondRate": 6.089,
"interactionNum": 1833,
"interactionBeyondRate": 4.912,
"collectNum": 200,
"likeNum": 791,
"collectBeyondRate": 5.06,
"likeBeyondRate": 2.424
},
{
"noteId": "69ad5b0b000000002203ac87",
"date": null,
"publishTime": "2026-03-08",
"type": 2,
"imgUrl": "http://ci.xiaohongshu.com/1040g00831tevimh558005pcp0b0ogdgr5ct59so?imageView2/2/w/540/format/jpg/q/75",
"title": "被儿子的女神节礼物整破防了😭",
"canJump": true,
"impNum": 3413,
"impBeyondRate": -0.905,
"readNum": 1142,
"readBeyondRate": -0.938,
"interactionNum": 69,
"interactionBeyondRate": -0.777,
"collectNum": 11,
"likeNum": 53,
"collectBeyondRate": -0.666,
"likeBeyondRate": -0.77
}
],
"pagePercentVo": {
"impHomefeedPercent": 0.942,
"impSearchPercent": 0.009,
"impFollowPercent": 0.012,
"impDetailPercent": 0.018,
"impNearbyPercent": 0.002,
"impOtherPercent": 0.01700000000000005,
"readHomefeedPercent": 0.963,
"readSearchPercent": 0.004,
"readFollowPercent": 0.005,
"readDetailPercent": 0.008,
"readNearbyPercent": 0.002,
"readOtherPercent": 0.01800000000000003
},
"longTermCommonNoteVo": {
"startPublishTime": "2025-07-12",
"endPublishTime": "2025-09-10",
"noteNumber": 64,
"recentReadNum": 156140,
"recentReadBeyondRate": "88.9",
"longTermReadNum": 12486,
"longTermReadBeyondRate": "88.3",
"recentSearchPagePercent": "0.1",
"recentFindPagePercent": "94.9",
"recentKolHomePagePercent": "0.6",
"recentFollowPagePercent": "0.7",
"recentOtherPagePercent": "3.8",
"longTermSearchPagePercent": "2.4",
"longTermFindPagePercent": "90.7",
"longTermKolHomePagePercent": "2.3",
"longTermFollowPagePercent": "1.8",
"longTermOtherPagePercent": "2.9"
},
"longTermCooperateNoteVo": {
"startPublishTime": "2025-07-12",
"endPublishTime": "2025-09-10",
"noteNumber": 0,
"recentReadNum": null,
"recentReadBeyondRate": null,
"longTermReadNum": null,
"longTermReadBeyondRate": null,
"recentSearchPagePercent": null,
"recentFindPagePercent": null,
"recentKolHomePagePercent": null,
"recentFollowPagePercent": null,
"recentOtherPagePercent": null,
"longTermSearchPagePercent": null,
"longTermFindPagePercent": null,
"longTermKolHomePagePercent": null,
"longTermFollowPagePercent": null,
"longTermOtherPagePercent": null
},
"mfollowCnt": 8,
"mengagementNum": 310,
"mEngagementNum": 310,
"mFollowCnt": 8
}
}💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。