小红书笔记列表API开发指南

一、前言

小红书作为中国领先的社交电商平台，其开放平台提供了笔记列表API接口，支持批量获取用户或关键词相关的笔记列表数据，包括笔记标题、封面图、互动数据等核心信息。该接口广泛应用于内容聚合、竞品分析及用户画像构建等场景。前往体验API：c0b.cc/R4rbK2 。

二、接口概述

1. ‌功能‌

• 支持按用户ID或关键词分页获取笔记列表，返回数据包含笔记基础信息（ID、标题、摘要）、作者信息、发布时间及互动指标（点赞、收藏、评论数）。

• 可选参数控制排序（如按热度、时间）和字段筛选（如fields参数指定返回字段）。

2. ‌请求方式‌

• HTTP GET请求，返回JSON格式数据。

• 必填参数：请求参数：q=女装&page=1&sort=&filter=
  参数说明：q:关键词,page:页码  filter：note(搜索笔记)

三、Python请求示例

以下代码展示如何调用小红书笔记列表API：

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 " 
app_key = "YOUR_APP_KEY" q = "衣服" # 目标关键词
# 请求示例 url 默认请求参数已经做URL编码
url = "smallredbook/item_search/?key=<您自己的apiKey>&secret=&q=女装&page=1&sort=&filter="
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)


‌代码说明‌：

1. 通过requests库发送GET请求，支持按用户ID或关键词查询笔记列表。

2. 添加分页参数（page_size和page_no）控制数据量，避免单次响应过大。

3. 包含异常处理逻辑，建议扩展重试机制以应对网络波动。