1. 接口信息（v2 標準）

地址：https://api.xiaohongshu.com/v2/notes/{note_id}/comments

方法：GET

鑒權：access_token（OAuth2.0，有效期約 2 小時，需刷新）

簽名：參數按 ASCII 排序 + App Secret 做 MD5

分頁：page/limit 或 cursor + has_more

2. 必傳參數

note_id：筆記 ID（從 URL / 分享鏈接提取）

access_token：授權令牌

timestamp：時間戳（秒級）

sign：簽名（防篡改）

3. Python 調用示例

python

運行

import requests
import hashlib
import time

def get_xhs_comments(note_id, app_key, app_secret, access_token, page=1, limit=20):
    url = f"https://api.xiaohongshu.com/v2/notes/{note_id}/comments"
    ts = str(int(time.time()))
    # 簽名拼接（按ASCII升序）
    sign_str = f"app_key{app_key}limit{limit}note_id{note_id}page{page}timestamp{ts}{app_secret}"
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    params = {
        "access_token": access_token,
        "app_key": app_key,
        "note_id": note_id,
        "page": page,
        "limit": limit,
        "timestamp": ts,
        "sign": sign
    }
    resp = requests.get(url, params=params)
    return resp.json() if resp.status_code == 200 else None

二、調用規范與風控（必守）

1. 頻率限制（默認）

每分鐘 ≤ 100 次；超限返回429

優化：緩存 + 重試（指數退避：1s→2s→4s）、批量異步、申請提額

2. 常見錯誤與處理

表格

3. 合規紅線（嚴禁觸碰）

禁止獲取 / 存儲用戶隱私（手機號、地址等）

評論用戶 ID 需脫敏（如user_12345→user_****5）

數據僅限申請用途，禁止商業營銷濫用

遵守《個人信息保護法》與小紅書開放平臺協議

三、數據處理與存儲

1. 數據結構（核心字段）

json

{
  "code": 0,
  "data": {
    "comments": [
      {
        "id": "評論ID",
        "content": "評論內容",
        "create_time": 1742450000,
        "user_info": {
          "user_id": "用戶ID",
          "nickname": "昵稱",
          "avatar": "頭像"
        },
        "like_count": 點贊數,
        "reply_count": 回復數
      }
    ],
    "has_more": true,
    "total": 123
  }
}

2. 處理流程

清洗：去重、過濾廣告 / 垃圾評論、脫敏

結構化：存入 MySQL/PostgreSQL（關系型）或 MongoDB（非結構化）

緩存：Redis 緩存高頻筆記（TTL≥10 分鐘）

增量更新：定時拉取新評論，避免全量重復

四、業務落地場景

內容分析：情感傾向、關鍵詞云、用戶需求挖掘

輿情監控：負面預警、競品評論對比

運營優化：高頻詞優化標題 / 文案、提煉賣點

客服自動化：提取疑問→自動回復→私域 SOP

BI 報表：對接 Tableau/DataEase 做可視化

五、性能與穩定性優化

異步請求：用aiohttp提升批量效率

批量調度：控制并發，避免集中請求

監控告警：對接 Prometheus/Grafana，監控 429/500 等異常

降級策略：API 不可用時，啟用緩存兜底

審核編輯 黃宇