小紅書 API：筆記搜尋、留言與回覆資料

依 2026-10-25 規格快照

快速解答

小紅書 API 以三組非同步任務提供資料：關鍵字搜尋筆記（/xhs/search/task）、以筆記網址蒐集留言（/xhs/pushs/task），以及公開帳號的貼文時間軸（/xhs/users/task）。規格中的小紅書端點一律使用 xhs 縮寫。留言任務可選排序方式，並可一併蒐集第二層回覆。資料以網路爬蟲蒐集小紅書公開發布的內容。

可取得的資料

欄位依 2026-10-25 規格快照。快照沒有逐一列出搜尋結果貼文的欄位，標示「示意樣本」的列取自下方示意資料，正式欄位以試用資料為準。快照也未將 post_id、parent_id 等關聯欄位標為必填，實際出現情形請以試用資料確認。

資料欄位端點
關鍵字搜尋的筆記（示意樣本） url, mblogid, author, author_id, content, tm, metadata_tags, like_count, comment_count, share_count GET /xhs/search/task/{task_id}
筆記留言與第二層回覆 id, post_id, author, author_id, content, push_type, sentiment, tm, tm_crawler, region GET /xhs/pushs/task/{task_id}
公開帳號的貼文時間軸 profile, timelines, task GET /xhs/users/task/{task_id}

端點一覽

Base URL 為 https://api.infominer.io/api/v2，每個請求以 auth-header 標頭帶 API 金鑰。主要參數中標示 * 者為必填。

方法路徑說明主要參數
POST /xhs/search/task 建立筆記關鍵字搜尋任務，可指定日期區間與最多爬取頁數。 keyword* end_date max_pages start_date
GET /xhs/search/task/{task_id} 輪詢筆記搜尋任務；DONE 時回傳筆記與 total_count，每頁最多 100 筆。 task_id* page pageSize
POST /xhs/pushs/task 以筆記網址建立留言任務，可選排序、第二層回覆與關閉重複檢查。 post_url* crawl_second_layer get_all order_type
GET /xhs/pushs/task/{task_id} 輪詢筆記留言任務；DONE 時回傳留言，每頁最多 1000 筆。 task_id* page pageSize
POST /xhs/users/task 建立公開帳號的貼文時間軸任務，需帶帳號 ID 與起訖日期。 author_id* endDate* startDate*
GET /xhs/users/task/{task_id} 輪詢時間軸任務；DONE 時回傳帳號資料與筆記時間軸。 task_id*

取資料流程

  1. POST /xhs/search/task 帶 keyword 與選填的 start_date、end_date、max_pages，取得任務 id。
  2. GET /xhs/search/task/{task_id} 輪詢：INIT 或 RUNNING 時繼續等待，DONE 時同一個回應帶回筆記（data）與 total_count（pageSize 最多 100），FAILED 時停止並處理失敗。
  3. 從筆記結果挑出要看留言的筆記，以筆記網址 POST /xhs/pushs/task；order_type 可選 hot、time、both，crawl_second_layer 為 true 時連同第二層回覆，get_all 為 true 時關閉重複檢查、蒐集全部留言。
  4. GET /xhs/pushs/task/{task_id} 取回留言，每頁最多 1000 筆。
  5. 需要特定公開帳號的發文紀錄時，POST /xhs/users/task 帶 author_id、startDate、endDate，DONE 後回傳 profile 與 timelines。

curl 範例

建立關鍵字搜尋任務

curl -X POST https://api.infominer.io/api/v2/xhs/search/task \
  -H "auth-header: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "护肤日常", "start_date": "2026-06-01", "end_date": "2026-06-30", "max_pages": 3}'

以任務 ID 輪詢

curl "https://api.infominer.io/api/v2/xhs/search/task/$TASK_ID?page=1&pageSize=100" \
  -H "auth-header: YOUR_API_KEY"

以筆記網址建立留言任務

curl -X POST https://api.infominer.io/api/v2/xhs/pushs/task \
  -H "auth-header: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_url": "https://www.xiaohongshu.com/explore/000000000000000000000001", "order_type": "time", "crawl_second_layer": true}'

示意 JSON 樣本

以下為人工撰寫的示意資料：帳號為 sample_user_n，ID 為明顯的假值，不是真實貼文。

建立任務的回應（示意資料）

{
  "id": "00000000-0000-4000-8000-000000000001",
  "keyword": "护肤日常",
  "status": "INIT"
}

任務完成後的輪詢回應（示意資料）

{
  "keyword": "护肤日常",
  "status": "DONE",
  "total_count": 2,
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "status": "DONE"
  },
  "data": [
    {
      "source": "xhs_note",
      "platform": "rednote",
      "url": "https://www.xiaohongshu.com/explore/000000000000000000000001",
      "mblogid": "000000000000000000000001",
      "content": "换季之后我把早晚的护肤步骤简化成四步，记录一下这个月的肤况 #护肤日常",
      "author": "sample_user_1",
      "author_id": "0000000000000001",
      "tm": 1781056800,
      "metadata_tags": [
        "护肤日常",
        "换季保养"
      ],
      "like_count": 120,
      "comment_count": 14,
      "share_count": 6
    },
    {
      "source": "xhs_note",
      "platform": "rednote",
      "url": "https://www.xiaohongshu.com/explore/000000000000000000000002",
      "mblogid": "000000000000000000000002",
      "content": "夜间保湿面膜的使用心得，敏感肌可以先小范围试用",
      "author": "sample_user_2",
      "author_id": "0000000000000002",
      "tm": 1781060400,
      "metadata_tags": [
        "保湿",
        "敏感肌"
      ],
      "like_count": 48,
      "comment_count": 5,
      "share_count": 2
    }
  ]
}

貼文與留言如何關聯

留言任務以筆記網址 post_url 建立，留言紀錄以 post_id 欄位指回所屬筆記，並有 push_type、author、author_id、tm 等欄位。開啟 crawl_second_layer 時也會蒐集第二層回覆；快照沒有說明第二層回覆在回應中的巢狀方式或與上層留言的關聯，請以試用資料確認。示意樣本中，筆記以 url 與 mblogid 識別，作者以 author 與 author_id 識別。

歷史範圍與限制

  • 搜尋結果 pageSize 最多 100，留言 pageSize 最多 1000。
  • 留言任務預設會做重複檢查；需要重新蒐集全部留言時，把 get_all 設為 true。
  • 公開帳號的貼文時間軸任務需同時帶 startDate 與 endDate（YYYY-MM-DD）。
  • 關鍵字搜尋可回溯的期間、筆記數量與更新頻率，依專案範圍確認。
蒐集方式：以網路爬蟲蒐集各平台公開發布的內容。是否適用於您的用途，依用途與法域由買方法務評估，我們可提供來源與蒐集方式說明。

交付格式

所有端點回傳 JSON。搜尋與留言任務在 DONE 後由輪詢回應帶回資料，可用 page、pageSize 分頁；時間軸任務的輪詢回應帶 profile 與 timelines。批次檔案或其他交付方式，依專案範圍確認。

申請試用

在下方表單勾選小紅書，說明要搜尋的關鍵字或品類、是否需要留言與第二層回覆，以及預估資料量。我們會確認範圍，並回覆試用與 API 金鑰的安排。

我們只會用您提供的資料回覆這次詢問，詳見隱私權政策。 或寫信到 [email protected]

常見問題

小紅書 API 的端點路徑為什麼是 /xhs/？
規格中的小紅書端點一律使用 xhs 縮寫，例如 /xhs/search/task 與 /xhs/pushs/task。
可以拿到筆記底下的留言與回覆嗎？
可以。以筆記網址建立 /xhs/pushs/task，crawl_second_layer 設為 true 時包含第二層回覆。
可以指定日期區間搜尋筆記嗎？
建立搜尋任務時帶 start_date 與 end_date（YYYY-MM-DD）；可回溯多遠依專案範圍確認。
可以追蹤特定帳號的筆記嗎？
可以建立公開帳號的貼文時間軸任務 /xhs/users/task，帶帳號 ID 與起訖日期。
小紅書資料是怎麼蒐集的？
以網路爬蟲蒐集小紅書公開發布的內容。是否適用於您的用途，依用途與法域由買方法務評估，我們可提供來源與蒐集方式說明。