Xiaohongshu Pgy APIs - Notes Details (V1)
Retrieve detailed note performance metrics.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
token | query | string | Yes | User authentication token. |
userId | query | string | Yes | KOL's user ID. |
advertiseSwitch | query | string | No | Advertisement filter. Available Values: - ALL: All notes- ORGANIC_ONLY: Organic notes only |
orderType | query | string | No | Sorting order. Available Values: - LATEST: Latest- MOST_READ: Most read- MOST_INTERACT: Most interactions |
noteType | query | string | No | Type of note. Available Values: - ALL: All types- COOPERATION: Cooperation notes- PHOTO_TEXT: Photo and Text- VIDEO: Video only |
isThirdPlatform | query | string | No | Whether from third-party platform. Available Values: - NO: No- YES: Yes |
pageNumber | query | integer | No | Page number. |
Code Samples
💡 Environment Note
Default samples use https://api.justoneapi.com (prod-global). For users in Mainland China, it is recommended to replace it with http://47.117.133.51:30015 (prod-cn) for better performance. See Environment Guide.
bash
# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/dataV2/notesDetail/v1?token=YOUR_API_KEY&userId=VALUE"text
I want to use the "Notes Details (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/dataV2/notesDetail/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/xiaohongshu-pgy-apis/notes-details-v1-en.json
Parameters:
- token (query): User authentication token. (Required)
- userId (query): KOL's user ID. (Required)
- advertiseSwitch (query): Advertisement filter.
Available Values:
- `ALL`: All notes
- `ORGANIC_ONLY`: Organic notes only
- orderType (query): Sorting order.
Available Values:
- `LATEST`: Latest
- `MOST_READ`: Most read
- `MOST_INTERACT`: Most interactions
- noteType (query): Type of note.
Available Values:
- `ALL`: All types
- `COOPERATION`: Cooperation notes
- `PHOTO_TEXT`: Photo and Text
- `VIDEO`: Video only
- isThirdPlatform (query): Whether from third-party platform.
Available Values:
- `NO`: No
- `YES`: Yes
- pageNumber (query): Page number.
Return format: JSON
Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set request timeout to at least 60 seconds.
3. Business Code Reference:
- 0: Success
- 100: Invalid or Inactive Token
- 301: Collection Failed. Please Retry.
- 302: Rate Limit Exceeded
- 303: Daily Quota Exceeded
- 400: Invalid Parameters
- 500: Internal Server Error
- 600: Permission Denied
- 601: Insufficient Balance
Please help me write a script in my preferred programming language to call this API and handle the response.python
# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
import requests
url = "https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/dataV2/notesDetail/v1?token=YOUR_API_KEY&userId=VALUE"
response = requests.get(url)
print(response.json())js
// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/kol/dataV2/notesDetail/v1?token=YOUR_API_KEY&userId=VALUE", {
method: "GET"
});
const data = await response.json();
console.log(data);java
// Tip: For Mainland China, replace https://api.justoneapi.com with 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/dataV2/notesDetail/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
// Tip: For Mainland China, replace https://api.justoneapi.com with 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/dataV2/notesDetail/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
// Tip: For Mainland China, replace https://api.justoneapi.com with 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/dataV2/notesDetail/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;Responses
json
{
"code": 0,
"data": {
"list": [
{
"readNum": 1142,
"likeNum": 53,
"collectNum": 11,
"isAdvertise": false,
"isVideo": true,
"noteId": "69ad5b0b000000002203ac87",
"imgUrl": "http://ci.xiaohongshu.com/1040g00831tevimh558005pcp0b0ogdgr5ct59so?imageView2/2/w/540/format/jpg/q/75",
"title": "被儿子的女神节礼物整破防了😭",
"brandName": null,
"date": "2026-03-08",
"thirdReadUserNum": 0
},
{
"readNum": 131324,
"likeNum": 791,
"collectNum": 200,
"isAdvertise": false,
"isVideo": true,
"noteId": "69abf843000000002603c375",
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31tdk8qj46ee05pcp0b0ogdgr5fbfslg?imageView2/2/w/540/format/jpg/q/75",
"title": "你家娃也是一关灯就要喝水吗😂",
"brandName": null,
"date": "2026-03-07",
"thirdReadUserNum": 0
},
{
"readNum": 29051,
"likeNum": 613,
"collectNum": 87,
"isAdvertise": false,
"isVideo": true,
"noteId": "69aab0360000000023039c1d",
"imgUrl": "http://ci.xiaohongshu.com/1040g00831tcc7a4c56005pcp0b0ogdgr5cbo97g?imageView2/2/w/540/format/jpg/q/75",
"title": "对孩子最好的爱的教育就是爸爸爱妈妈",
"brandName": null,
"date": "2026-03-06",
"thirdReadUserNum": 0
},
{
"readNum": 92987,
"likeNum": 566,
"collectNum": 71,
"isAdvertise": false,
"isVideo": true,
"noteId": "69a9581300000000260315e2",
"imgUrl": "http://ci.xiaohongshu.com/1040g00831tb26t83le005pcp0b0ogdgrup8ekno?imageView2/2/w/540/format/jpg/q/75",
"title": "情绪这块把控的刚刚好😂",
"brandName": null,
"date": "2026-03-05",
"thirdReadUserNum": 0
},
{
"readNum": 91927,
"likeNum": 408,
"collectNum": 60,
"isAdvertise": false,
"isVideo": true,
"noteId": "69a6bccd00000000220336c3",
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31t8gnf9b58e05pcp0b0ogdgrdkc4g5o?imageView2/2/w/540/format/jpg/q/75",
"title": "姐姐：我要验牌！ 团团：我只关心吃",
"brandName": null,
"date": "2026-03-03",
"thirdReadUserNum": 0
},
{
"readNum": 85581,
"likeNum": 1082,
"collectNum": 90,
"isAdvertise": false,
"isVideo": true,
"noteId": "69a55e120000000026030063",
"imgUrl": "http://ci.xiaohongshu.com/1040g00831t75udvh6e005pcp0b0ogdgr1e17nlg?imageView2/2/w/540/format/jpg/q/75",
"title": "所以说男孩子一定要多跟爸爸接触！",
"brandName": null,
"date": "2026-03-02",
"thirdReadUserNum": 0
},
{
"readNum": 7442,
"likeNum": 191,
"collectNum": 16,
"isAdvertise": false,
"isVideo": true,
"noteId": "69a415610000000026033bb5",
"imgUrl": "http://ci.xiaohongshu.com/1040g2sg31t5tqedd5a705pcp0b0ogdgrgj8otdo?imageView2/2/w/540/format/jpg/q/75",
"title": "父母恩爱才是对孩子最好的教育！",
"brandName": null,
"date": "2026-03-01",
"thirdReadUserNum": 0
},
{
"readNum": 13588,
"likeNum": 159,
"collectNum": 28,
"isAdvertise": false,
"isVideo": true,
"noteId": "69a17011000000002602c2d4",
"imgUrl": "http://ci.xiaohongshu.com/1040g00831t3b4i80l6005pcp0b0ogdgrbrcehdo?imageView2/2/w/540/format/jpg/q/75",
"title": "凭实力把自己养活😂",
"brandName": null,
"date": "2026-02-27",
"thirdReadUserNum": 0
}
],
"total": 72
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.