Skip to content

小红书蒲公英 API - 笔记详情 (V1)

此接口已过期

此接口已过时,可能会在未来的版本中被移除。请尽快迁移到新版本。

prod-global
GET
/api/xiaohongshu-pgy/get-note-detail/v1

获取笔记详情(旧版)。

请求参数

参数名位置类型必填说明
tokenquerystring用户鉴权令牌。
noteIdquerystring笔记ID。
acceptCachequeryboolean启用缓存。

代码示例

💡 环境说明

默认示例使用 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/get-note-detail/v1?token=YOUR_API_KEY&noteId=VALUE"
text
我想使用 Just One API 提供的“笔记详情 (V1) [已弃用]”接口。
接口地址: https://api.justoneapi.com/api/xiaohongshu-pgy/get-note-detail/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/xiaohongshu-pgy-apis/note-details-v1-deprecated-zh.json

请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- noteId (query): 笔记ID。 (必填)
- acceptCache (query): 启用缓存。

返回格式: 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/get-note-detail/v1?token=YOUR_API_KEY&noteId=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/get-note-detail/v1?token=YOUR_API_KEY&noteId=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/get-note-detail/v1?token=YOUR_API_KEY&noteId=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/get-note-detail/v1?token=YOUR_API_KEY&noteId=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/get-note-detail/v1?token=YOUR_API_KEY&noteId=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": "67f32a94000000001d02eb4a",
    "noteLink": "https://www.xiaohongshu.com/explore/67f32a94000000001d02eb4a?xsec_token=MBhBJYIiKLzqhnqYBouOdEG79_loLP-kryE6IgEeqLViY=&xsec_source=pc_pgy",
    "userId": "674eadbb000000001c01981e",
    "headPhoto": null,
    "name": null,
    "redId": null,
    "type": 1,
    "atUserList": null,
    "title": "上海落户普通人指南",
    "content": "✌️听说了吗?家人们!上海真的太给力啦!!\n上海为了吸引和留住人才,开年就对上海落户zc再次迎来调整,为各类人才提供更加清晰、多元化的落户路径。很多宝子可能都不知道🤷,千万不能错过哦!!\n-\n✅这次申请上海户口pass三个限制!\n🎈居转户前4年不规定社保!!累计缴纳2倍就行\n🎈人才引进换公司社保可以中断!!\n🎈留学生第一份工作可以不在上海!!\n-\n⭕️但是户口不是白拿的,需要满足其中一个条件哦~\n1️⃣居转户落户\n7年居转户+无中级职称+后4年36个月2倍社保\n7年居转户+有中级职称+后4年36个月1.3倍社保\n5年居住证+5年社保+后4年36个月3倍社保\n5年居住证+5年社保+临港企业其中3年1倍社保\n\t\n2️⃣留学生\nTop50直接落户\nTop51-100+6个月社保/不限基数\nTop101-500+半年1倍社保 Top500以外+1年1.5倍社保\n留学生+入职事业单位有编制\n\t\n3️⃣人才引进落户\n本科双证+高新企业+2年2倍社保\n硕士+高新企业+1年2倍社保\n高级职称+半年2倍社保\n企业高管+3年纳税百万+3倍社保\n-\n申请上海户口有利有弊,需根据个人情况权衡。如果长期在上海发展,那么这些条件是比较利好的。\n希望对大家有帮助,有想申请的,或者解决不了的也可以先嘶我了解!\n#上海落户[话题]##落户上海[话题]##落户[话题]##居转户[话题]##居转户落户上海[话题]##留学生落户[话题]##上海留学生落户[话题]##人才引进[话题]##人才引进落户上海[话题]#",
    "imagesList": [
      {
        "fileId": "1040g2sg31g0do7qs0g805pqelmtn360u19eae60",
        "url": "http://ci.xiaohongshu.com/1040g2sg31g0do7qs0g805pqelmtn360u19eae60?imageView2/2/w/1080/format/jpg",
        "original": "http://ci.xiaohongshu.com/1040g2sg31g0do7qs0g805pqelmtn360u19eae60",
        "width": 1242,
        "height": 1656,
        "latitude": null,
        "longitude": null,
        "traceId": "1040g2sg31g0do7qs0g805pqelmtn360u19eae60",
        "sticker": null
      }
    ],
    "videoInfo": null,
    "time": {
      "createTime": 1743989396000,
      "updateTime": 1744424439000,
      "userUpdateTime": 1744074482000
    },
    "createTime": "2025-04-07 09:29",
    "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/1040g2jo31c50829vh0005pqelmtn360uj9tdd3o?imageView2/2/w/120/format/jpg",
      "userId": "674eadbb000000001c01981e",
      "advertiserId": null,
      "fansNum": 566,
      "cooperType": 2,
      "priceState": null,
      "pictureState": null,
      "picturePrice": null,
      "videoState": null,
      "videoPrice": null,
      "userType": 1,
      "operateState": null,
      "currentLevel": null,
      "location": "",
      "contentTags": [],
      "featureTags": [],
      "personalTags": [],
      "gender": "女",
      "isCollect": false,
      "clickMidNum": 0,
      "interMidNum": 0,
      "pictureInCart": null,
      "videoInCart": null,
      "kolType": null,
      "mengagementNum": 0,
      "mEngagementNum": 0
    },
    "compClickData": null
  }
}

💡 提示:为简化展示,列表类数据样例仅保留 1-2 条记录,实际返回条数以接口响应为准。