小红书笔记详情 API 实战指南：从开发对接、场景落地到收益挖掘（附避坑技巧）

import hashlib
import time
def generate_sign(params, app_secret):
    # 坑点1：参数必须按ASCII码升序排序，乱序必失败
    sorted_items = sorted(params.items(), key=lambda x: x[0])
    # 拼接格式：key+value连写，无分隔符
    params_str = "".join([f"{k}{v}" for k, v in sorted_items])
    # 坑点2：首尾必须加app_secret，少一边都不行
    sign_str = f"{app_secret}{params_str}{app_secret}"
    # MD5加密后转小写（部分平台要大写，小红书是小写）
    return hashlib.md5(sign_str.encode("utf-8")).hexdigest()
# 测试示例
app_secret = "your_app_secret"
params = {
    "app_key": "your_app_key",
    "timestamp": str(int(time.time())),  # 秒级时间戳
    "note_id": "123456789",  # 目标笔记ID
    "sign_method": "md5"
}
print(generate_sign(params, app_secret))  # 输出正确签名

import requests
import hashlib
import time
class XiaohongshuNoteAPI:
    def __init__(self, app_key, app_secret):
        self.app_key = app_key
        self.app_secret = app_secret
        self.api_path = "/api/v1/note/detail"  # 仅保留路径，无完整链接
    def generate_sign(self, params):
        # 复用上面的签名函数
        sorted_items = sorted(params.items(), key=lambda x: x[0])
        params_str = "".join([f"{k}{v}" for k, v in sorted_items])
        sign_str = f"{self.app_secret}{params_str}{self.app_secret}"
        return hashlib.md5(sign_str.encode("utf-8")).hexdigest()
    def get_note_detail(self, note_id):
        # 1. 构建基础参数
        params = {
            "app_key": self.app_key,
            "timestamp": str(int(time.time())),
            "note_id": note_id,
            "sign_method": "md5"
        }
        # 2. 生成签名
        params["sign"] = self.generate_sign(params)
        # 3. 发送请求（实际对接时补全域名，此处省略）
        headers = {"Content-Type": "application/json"}
        try:
            # 注意：实际开发需替换为官方域名+api_path
            response = requests.get(
                url=f"https://open-api.xiaohongshu.com{self.api_path}",
                params=params,
                headers=headers,
                timeout=10
            )
            response.raise_for_status()  # 捕获4xx/5xx错误
            return self.parse_result(response.json())
        except Exception as e:
            print(f"调用失败：{str(e)}")
            return None
    def parse_result(self, raw_data):
        # 坑点3：处理表情符号导致的JSON解析错误
        import re
        def filter_emoji(text):
            if not text:
                return ""
            return re.sub(r"[^\u4e00-\u9fa5a-zA-Z0-9\s,.!?]", "", text)
        if raw_data.get("code") != 0:
            print(f"接口报错：{raw_data.get('message')}")
            return None
        data = raw_data["data"]
        # 结构化解析核心字段
        return {
            "note_id": data["note_id"],
            "title": filter_emoji(data["title"]),
            "content": filter_emoji(data["content"]),
            "images": data.get("images", []),  # 图片列表
            "interactive": {
                "likes": data.get("likes", 0),
                "comments": data.get("comments", 0),
                "collections": data.get("collections", 0)
            },
            "author": {
                "nickname": filter_emoji(data["author"]["nickname"]),
                "fans": data["author"].get("fans_count", 0)
            },
            "tags": data.get("tags", []),  # 话题标签
            "create_time": data.get("create_time", "")
        }
# 用法示例
if __name__ == "__main__":
    api = XiaohongshuNoteAPI("your_app_key", "your_app_secret")
    note_detail = api.get_note_detail("123456789")
    if note_detail:
        print(f"笔记标题：{note_detail['title']}")
        print(f"点赞数：{note_detail['interactive']['likes']}")
        print(f"作者昵称：{note_detail['author']['nickname']}")