小紅書帳號時間軸 API

依 2026-10-25 規格快照

快速解答

以 author_id、startDate 與 endDate(皆為必填,日期格式為 YYYY-MM-DD)呼叫 POST /xhs/users/task,會建立任務,蒐集小紅書公開帳號在該區間內的筆記。以 GET /xhs/users/task/{task_id} 輪詢;DONE 時回傳帳號 ID、profile 物件、timelines 與任務資訊。timelines 可能是清單,也可能是帶有 data 與 pagination 的物件;時間軸任務的輪詢不帶分頁參數。資料以網路爬蟲蒐集小紅書公開發布的內容。

常見用途

  • 追蹤品牌官方帳號或創作者在活動期間發布的內容。
  • 為研究保存公開帳號的筆記紀錄,每則附日期。
  • 比較同一類別的多個帳號在同一期間內的發文頻率。

端點一覽

Base URL 為 https://api.infominer.io/api/v2,每個請求以 auth-header 標頭帶 API 金鑰。

方法路徑說明
POST /xhs/users/task 建立公開帳號的貼文時間軸任務,需帶帳號 ID 與起訖日期。
GET /xhs/users/task/{task_id} 輪詢時間軸任務;DONE 時回傳帳號資料與筆記時間軸。

請求參數

POST /xhs/users/task

參數位置型別必填預設值/可用值說明
author_id body string 是 公開帳號的帳號 ID。
endDate body string 是 結束日期(YYYY-MM-DD)。
startDate body string 是 開始日期(YYYY-MM-DD)。

GET /xhs/users/task/{task_id}

參數位置型別必填預設值/可用值說明
task_id path string 是 建立任務時回傳的任務 ID。

回應欄位

資料欄位端點
公開帳號的貼文時間軸 id, profile, timelines, task GET /xhs/users/task/{task_id}

程式碼範例

curl:建立任務

curl -X POST https://api.infominer.io/api/v2/xhs/users/task \
  -H "auth-header: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"author_id": "0000000000000001", "startDate": "2026-06-01", "endDate": "2026-06-30"}'

curl:以任務 ID 輪詢

curl "https://api.infominer.io/api/v2/xhs/users/task/$TASK_ID" \
  -H "auth-header: YOUR_API_KEY"

Python(requests):建立、輪詢、讀取

import time
import requests

BASE_URL = "https://api.infominer.io/api/v2"
HEADERS = {"auth-header": "YOUR_API_KEY"}

# 1. Create the task
resp = requests.post(
    f"{BASE_URL}/xhs/users/task",
    headers=HEADERS,
    json={
        "author_id": "0000000000000001",
        "startDate": "2026-06-01",
        "endDate": "2026-06-30",
    },
    timeout=30,
)
resp.raise_for_status()
task = resp.json()

# 2. Poll until the task leaves INIT / RUNNING
for _ in range(120):
    resp = requests.get(
        f"{BASE_URL}/xhs/users/task/{task['id']}",
        headers=HEADERS,
        timeout=30,
    )
    resp.raise_for_status()
    result = resp.json()
    status = result.get("status") or result.get("task", {}).get("status")
    if status not in ("INIT", "RUNNING"):
        break
    time.sleep(15)
else:
    raise SystemExit("task still running; poll it again later")

if status == "FAILED":
    raise SystemExit("task failed")
if status != "DONE":
    print("task ended with status", status, "- results may be incomplete")

# 3. Read the profile and the timeline
print(result.get("profile"))
timelines = result.get("timelines")
rows = timelines.get("data", []) if isinstance(timelines, dict) else (timelines or [])
print(len(rows), "posts")

示意回應樣本

以下為人工撰寫的示意資料:帳號為 sample_user_n,ID 為明顯的假值。欄位依 2026-10-25 規格快照;樣本只呈現部分欄位,完整清單見上方表格。

建立任務的回應(示意資料)。快照沒有逐一列出 profile 與 timelines 內的欄位,請以試用資料確認。

{
  "id": "00000000-0000-4000-8000-000000000001",
  "author_id": "0000000000000001",
  "startDate": "2026-06-01",
  "endDate": "2026-06-30",
  "status": "INIT",
  "tm": 1780272000
}

限制與注意事項

  • author_id、startDate 與 endDate 皆為必填。
  • timelines 以清單回傳,或以帶有 data 與 pagination 的物件回傳。
  • 只蒐集小紅書公開發布的內容。
  • 時間軸可回溯的期間與更新頻率,依專案範圍確認。
蒐集方式:以網路爬蟲蒐集各平台公開發布的內容。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。

更多 小紅書 API 頁面

申請試用

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

填寫表單申請試用,專人確認範圍後回覆試用與介接安排。

填寫申請表單

常見問題

可以蒐集非公開帳號的筆記嗎?
不行。只蒐集小紅書公開發布的內容。
時間軸包含留言嗎?
時間軸任務蒐集的是該帳號的筆記。要蒐集留言,請用小紅書留言 API 為每個筆記網址建立留言任務。
時間軸結果有分頁嗎?
輪詢不帶分頁參數。timelines 以清單回傳,或以帶有 data 與 pagination 的物件回傳。
資料是怎麼蒐集的?這是小紅書官方的 API 嗎?
資料以網路爬蟲蒐集小紅書公開發布的內容。LargitData 與小紅書沒有隸屬或合作關係,這也不是小紅書自身提供的 API。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。