小红书 API - 笔记动态 (V1)

prod-global

GET

/api/xiaohongshu/get-note-feed/v1

获取小红书笔记信息流，返回分页的推荐笔记列表。每个信息流条目通常包含笔记基本信息（如笔记ID、标题/文本片段、封面/媒体信息）、作者信号（如可用时）以及互动计数器（如可用时）。

典型使用场景：

追踪平台趋势及推荐内容
构建用于发现、分析和报告的数据集
发现新兴笔记/创作者以供监测

请求参数

参数名	位置	类型	必填	说明
`token`	query	`string`	是	此 API 服务的访问令牌。
`oid`	query	`string`	否	信息流标识符。可用值： - `homefeed_recommend`：推荐 - `homefeed_video_v3`：视频 - `homefeed_live`：直播 - `homefeed_fashion_v3`：时尚 - `homefeed_books_v3`：书籍 - `homefeed_nails_v3`：美甲 - `homefeed_painting_v3`：绘画 - `homefeed_cartoon_v3`：动漫 - `homefeed_photography_v3`：摄影 - `homefeed_food_v3`：美食 - `homefeed_celebrity_v3`：明星 - `homefeed_profile_photo_v3`：头像 - `homefeed_gaming_v3`：游戏 - `homefeed_cosmetics_v3`：美妆 - `homefeed_stationery_v3`：文具 - `homefeed_love_v3`：情感 - `homefeed_music_v3`：音乐 - `homefeed_movie_and_tv_v3`：影视 - `homefeed_handmade_v3`：手工 - `homefeed_education_v3`：教育 - `homefeed_digital_technology_v3`：数码科技 - `homefeed_household_product_v3`：家居用品 - `homefeed_hair_v3`：发型 - `homefeed_pets_v3`：宠物 - `homefeed_travel_v3`：旅行 - `homefeed_lose_weight_v3`：减肥 - `homefeed_dance_v3`：舞蹈 - `homefeed_skincare_v3`：护肤 - `homefeed_home_decoration_v3`：家装 - `homefeed_fashion_shoes_v3`：潮鞋 - `homefeed_wallpaper_v3`：壁纸 - `homefeed_career_v3`：职场 - `homefeed_funny_v3`：搞笑 - `homefeed_maternity_v3`：母婴 - `homefeed_cars_v3`：汽车 - `homefeed_weddings_v3`：婚礼 - `homefeed_bags_v3`：箱包 - `homefeed_trend_art_v3`：潮流艺术 - `homefeed_designer_toys_v3`：潮玩 - `homefeed_science_popularization_v3`：科普 - `homefeed_variety_show_v3`：综艺
`page`	query	`integer`	否	用于分页的页码。

代码示例

💡 环境说明

默认示例使用 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/get-note-feed/v1?token=YOUR_API_KEY"

text

我想使用 Just One API 提供的“笔记动态 (V1)”接口。
接口地址: https://api.justoneapi.com/api/xiaohongshu/get-note-feed/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/xiaohongshu-apis/notes-feed-v1-zh.json

请求参数说明:
- token (query): 此 API 服务的访问令牌。 (必填)
- oid (query): 信息流标识符。

可用值：
- `homefeed_recommend`：推荐
- `homefeed_video_v3`：视频
- `homefeed_live`：直播
- `homefeed_fashion_v3`：时尚
- `homefeed_books_v3`：书籍
- `homefeed_nails_v3`：美甲
- `homefeed_painting_v3`：绘画
- `homefeed_cartoon_v3`：动漫
- `homefeed_photography_v3`：摄影
- `homefeed_food_v3`：美食
- `homefeed_celebrity_v3`：明星
- `homefeed_profile_photo_v3`：头像
- `homefeed_gaming_v3`：游戏
- `homefeed_cosmetics_v3`：美妆
- `homefeed_stationery_v3`：文具
- `homefeed_love_v3`：情感
- `homefeed_music_v3`：音乐
- `homefeed_movie_and_tv_v3`：影视
- `homefeed_handmade_v3`：手工
- `homefeed_education_v3`：教育
- `homefeed_digital_technology_v3`：数码科技
- `homefeed_household_product_v3`：家居用品
- `homefeed_hair_v3`：发型
- `homefeed_pets_v3`：宠物
- `homefeed_travel_v3`：旅行
- `homefeed_lose_weight_v3`：减肥
- `homefeed_dance_v3`：舞蹈
- `homefeed_skincare_v3`：护肤
- `homefeed_home_decoration_v3`：家装
- `homefeed_fashion_shoes_v3`：潮鞋
- `homefeed_wallpaper_v3`：壁纸
- `homefeed_career_v3`：职场
- `homefeed_funny_v3`：搞笑
- `homefeed_maternity_v3`：母婴
- `homefeed_cars_v3`：汽车
- `homefeed_weddings_v3`：婚礼
- `homefeed_bags_v3`：箱包
- `homefeed_trend_art_v3`：潮流艺术
- `homefeed_designer_toys_v3`：潮玩
- `homefeed_science_popularization_v3`：科普
- `homefeed_variety_show_v3`：综艺
- page (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/get-note-feed/v1?token=YOUR_API_KEY"
response = requests.get(url)
print(response.json())

// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/xiaohongshu/get-note-feed/v1?token=YOUR_API_KEY", {
  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/get-note-feed/v1?token=YOUR_API_KEY"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

// 提示: 中国大陆地区建议将 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/get-note-feed/v1?token=YOUR_API_KEY"
	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/get-note-feed/v1?token=YOUR_API_KEY");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;

[OpenAPI 定义 (JSON)]

响应结果

json

{
  "code": 0,
  "data": [
    {
      "id": "699fdc5c000000000e00f4cd",
      "type": "normal",
      "timestamp": 1772084316,
      "name": "成都！这棵樱花树开爆了！！！竟然没人拍！！！",
      "title": "成都！这棵樱花树开爆了！！！竟然没人拍！！！",
      "desc": "",
      "likes": 4,
      "user": {
        "nickname": "贪玩小晕吖",
        "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31aci7i9vna005og0nof8che6qr6mr3g?imageView2/2/w/80/f...",
        "followed": false,
        "fstatus": "none",
        "userid": "6200be1e00000000210245c6"
      },
      "last_update_time": 0,
      "display_title": "成都！这棵樱花树开爆了！！！竟然没人拍！！！",
      "images_list": [
        {
          "height": 1920,
          "width": 1440,
          "url": "https://sns-i8.rednotecdn.com/notes_pre_post/1040g3k031t1pl2kf5kc05og0nof8che60g76fco?imageView2/2/w...",
          "original": "",
          "fileid": "notes_pre_post/1040g3k031t1pl2kf5kc05og0nof8che60g76fco",
          "url_size_large": "https://sns-i8.rednotecdn.com/notes_pre_post/1040g3k031t1pl2kf5kc05og0nof8che60g76fco?imageView2/2/w...",
          "trace_id": "notes_pre_post/1040g3k031t1pl2kf5kc05og0nof8che60g76fco",
          "url_multi_level": {
            "low": "https://sns-i8.rednotecdn.com/notes_pre_post/1040g3k031t1pl2kf5kc05og0nof8che60g76fco?imageView2/2/w...",
            "medium": "https://sns-i8.rednotecdn.com/notes_pre_post/1040g3k031t1pl2kf5kc05og0nof8che60g76fco?imageView2/2/w...",
            "high": "https://sns-i8.rednotecdn.com/notes_pre_post/1040g3k031t1pl2kf5kc05og0nof8che60g76fco?imageView2/2/w..."
          },
          "need_load_original_image": false,
          "thumb_hash": "oxgGDQK0iI2I+XhYiHlnh1FwBHWJ",
          "rgb": "0xcfc3b6"
        }
      ],
      "inlikes": false,
      "model_type": "note",
      "is_ads": false,
      "is_tracking": false,
      "debug_info_str": "{\"videofeedLazyLoadScore\":\"0.5958698\"}",
      "is_tracking_upgrade": false,
      "has_music": false,
      "is_top_show_eco_officer_note": false,
      "pk_status_info": "{\"ubtsecret\":\"RBGqmc7Jb/azO8KxrqoLo7bpAyomRWtHaErCr58cLzOwDZr6rMKwwmO6laXbEEbS6SKhwwMQTkEy5PkmoKHV4N...",
      "advanced_widgets_groups": {
        "groups": [
          {
            "mode": 1,
            "fetch_types": [
              "guos_test"
            ]
          }
        ]
      },
      "widgets_context": "{\"flags\":{},\"author_id\":\"6200be1e00000000210245c6\",\"author_name\":\"贪玩小晕吖\"}",
      "corner_tag": [],
      "rec_extra_info": "{\"followConductVideoTime\":\"-1\",\"followConductReason\":\"\",\"needInnerSharePrompt\":\"false\",\"needSharePro...",
      "rec_params": "{\"isNiceNote\":0,\"hfTrackId\":\"2g19pa3vq1j0oxhd21e9u\"}",
      "recommend": {
        "desc": "",
        "icon": "",
        "type": "",
        "dark_icon": "",
        "target_id": "",
        "target_name": "",
        "track_id": "dssmbase_recall_dssm_newneg_ali_imp_1hour@2g19pa3vq1j0oxhd21e9u",
        "topic_id": "",
        "topic_name": "",
        "mf_topic_id": "",
        "mf_topic_name": "",
        "topic_type": "",
        "topic_sub_type": "",
        "is_super_topic": false,
        "is_followed_topic": false,
        "category_id": "5ab094be481d26b8ef9045f0",
        "category_name": "旅游",
        "predict_click_ratio": 0.21813332,
        "predict_video_complete_ratio": 0.31263548,
        "is_activate_search": false,
        "videofeed_lazy_load_score": 0.5958698
      },
      "dislike_optional": {
        "follow_user": false
      },
      "cursor_score": "1772084648.9990",
      "app_json_string": "{\"note_need_unique\":true}",
      "downgrade_data": 0,
      "track_id_mix_rank": "2g19pa3vq1j0oxhd21e9u",
      "generate_item_index": 0,
      "rec_result_from_inner_cache": false
    }
  ]
}

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

小红书 API - 笔记动态 (V1) ​

请求参数 ​

代码示例 ​

响应结果 ​

小红书 API - 笔记动态 (V1)

请求参数

代码示例

响应结果