小红书蒲公英 API - 笔记详情 (V1)
获取特定笔记的详细信息。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
token | query | string | 是 | 用户鉴权令牌。 |
noteId | query | string | 是 | 笔记的唯一ID。 |
代码示例
💡 环境说明
默认示例使用 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/note/noteId/detail/v1?token=YOUR_API_KEY¬eId=VALUE"text
我想使用 Just One API 提供的“笔记详情 (V1)”接口。
接口地址: https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/note/noteId/detail/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/xiaohongshu-pgy-apis/note-details-v1-zh.json
请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- noteId (query): 笔记的唯一ID。 (必填)
返回格式: 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/note/noteId/detail/v1?token=YOUR_API_KEY¬eId=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/note/noteId/detail/v1?token=YOUR_API_KEY¬eId=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/note/noteId/detail/v1?token=YOUR_API_KEY¬eId=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/note/noteId/detail/v1?token=YOUR_API_KEY¬eId=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/note/noteId/detail/v1?token=YOUR_API_KEY¬eId=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": {
"noteId": "65c0b3fc000000002c037a49",
"noteLink": "https://www.xiaohongshu.com/explore/65c0b3fc000000002c037a49?xsec_token=MBZ5JOqdwczIfWfPBnr07jLpjhAUQ4Udcjkil5rH-2RFg=&xsec_source=pc_pgy",
"userId": "62060e8c0000000010008f55",
"headPhoto": "https://sns-avatar-qc.xhscdn.com/avatar/1000g2jo2pdfsn8cjs0005og61q6413qlmn6hsa0?imageView2/2/w/120/format/jpg",
"name": "曹操来了",
"redId": null,
"type": 2,
"atUserList": null,
"title": "",
"content": "拍狙击手的时候张艺谋说了这句话让曹操觉得皮特别冷心特别暖 #电影狙击手[话题]# #曹操来了[话题]# #明星[话题]#",
"imagesList": [
{
"fileId": "spectrum/1040g0k030ups4ufllg005og61q6413qltc9ngeo",
"url": "http://ci.xiaohongshu.com/spectrum/1040g0k030ups4ufllg005og61q6413qltc9ngeo?imageView2/2/w/1080/format/jpg",
"original": "http://ci.xiaohongshu.com/spectrum/1040g0k030ups4ufllg005og61q6413qltc9ngeo",
"width": 1080,
"height": 1920,
"latitude": null,
"longitude": null,
"traceId": "spectrum/1040g0k030ups4ufllg005og61q6413qltc9ngeo",
"sticker": null,
"imageExtraInfo": null
}
],
"videoInfo": {
"id": "112137331",
"videoKey": "stream/110/258/01e5c0b37e064fea010376038d78bf83b6_258.mp4",
"originVideoKey": "spectrum/1040g0jg30ups4uac5i005og61q6413ql180l93g",
"meta": {
"width": 1080,
"height": 1920,
"duration": 23,
"videoId": "136727240850690026"
},
"gifKey": "",
"videoUrl": "http://v.xiaohongshu.com/stream/110/258/01e5c0b37e064fea010376038d78bf83b6_258.mp4?sign=d9240bb7cd83add45a7f6b8f6640600b&t=69b04000",
"gifUrl": "",
"videoKeyList": [],
"hasFragments": false,
"thumbnail": "110/0/01e5c0b37e064fea0010000000018d78bf1fd7_0.webp",
"firstFrame": null,
"volume": 0,
"chapters": null,
"redGifInfo": null
},
"time": {
"createTime": 1707127804000,
"updateTime": 1707142186000,
"userUpdateTime": 1707127804000
},
"createTime": "2024-02-05 18:10",
"impNum": 0,
"likeNum": 0,
"favNum": 0,
"cmtNum": 0,
"readNum": 0,
"shareNum": 0,
"followCnt": 0,
"reportBrandUserId": null,
"reportBrandName": null,
"featureTags": null,
"userInfo": {
"nickName": "曹操来了",
"avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1000g2jo2pdfsn8cjs0005og61q6413qlmn6hsa0?imageView2/2/w/120/format/jpg",
"userId": "62060e8c0000000010008f55",
"advertiserId": null,
"fansNum": 498837,
"cooperType": 1,
"priceState": 1,
"pictureState": 0,
"picturePrice": 0,
"videoState": 1,
"videoPrice": 200000,
"userType": 2,
"operateState": 1,
"currentLevel": 2,
"location": "北京",
"contentTags": [
{
"taxonomy1Tag": "文化艺术",
"taxonomy2Tags": [
"科普"
]
}
],
"featureTags": null,
"personalTags": null,
"gender": "男",
"isCollect": false,
"clickMidNum": 70177,
"interMidNum": 2589,
"pictureInCart": null,
"videoInCart": null,
"kolType": 0,
"mengagementNum": 2925,
"mEngagementNum": 2925
},
"compClickData": null
}
}💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。