小紅書筆記搜尋 API
依 2026-10-25 規格快照
快速解答
POST /xhs/search/task 會以單一關鍵字建立非同步任務,爬取小紅書(RedNote,簡體中文寫作「小红书」)的搜尋結果,可選用 start_date、end_date 與 max_pages 限定範圍。以 GET /xhs/search/task/{task_id} 輪詢;DONE 時,同一個回應帶回筆記與 total_count,每頁最多 100 筆。在示意樣本中,每則筆記有網址、mblogid、作者、內文、時間戳記、中繼資料標籤,以及按讚數、留言數與分享數。小紅書的端點一律使用 xhs 縮寫。資料以網路爬蟲蒐集小紅書公開發布的內容。
常見用途
- 研究使用者在美妝、時尚、旅遊、美食等生活風格類別中如何評價與推薦產品。
- 蒐集提到某個品牌或競爭對手的筆記,了解哪些產品與說法被提及。
- 挑出值得細讀的筆記,再以留言 API 蒐集其留言。
端點一覽
Base URL 為 https://api.infominer.io/api/v2,每個請求以 auth-header 標頭帶 API 金鑰。
| 方法 | 路徑 | 說明 |
|---|---|---|
| POST | /xhs/search/task |
建立筆記關鍵字搜尋任務,可指定日期區間與最多爬取頁數。 |
| GET | /xhs/search/task/{task_id} |
輪詢筆記搜尋任務;DONE 時回傳筆記與 total_count,每頁最多 100 筆。 |
請求參數
POST /xhs/search/task
| 參數 | 位置 | 型別 | 必填 | 預設值/可用值 | 說明 |
|---|---|---|---|---|---|
keyword |
body | string | 是 | 搜尋關鍵字。 | |
end_date |
body | string | 否 | 晚於此日期的貼文不蒐集(YYYY-MM-DD)。 | |
max_pages |
body | integer | 否 | 最多爬取的結果頁數。 | |
start_date |
body | string | 否 | 蒐集到早於此日期的貼文時停止(YYYY-MM-DD)。 |
GET /xhs/search/task/{task_id}
| 參數 | 位置 | 型別 | 必填 | 預設值/可用值 | 說明 |
|---|---|---|---|---|---|
task_id |
path | string | 是 | 建立任務時回傳的任務 ID。 | |
page |
query | integer | 否 | 1 |
頁碼,從 1 開始。 |
pageSize |
query | integer | 否 | 100 |
每頁筆記數,最多 100。 |
回應欄位
| 資料 | 欄位 | 端點 |
|---|---|---|
| 筆記(示意樣本) | url, mblogid, author, author_id, content, tm, metadata_tags, like_count, comment_count, share_count | GET /xhs/search/task/{task_id} |
程式碼範例
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}'
curl:以任務 ID 輪詢
curl "https://api.infominer.io/api/v2/xhs/search/task/$TASK_ID?page=1&pageSize=100" \
-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/search/task",
headers=HEADERS,
json={
"keyword": "护肤日常",
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"max_pages": 3,
},
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/search/task/{task['id']}",
headers=HEADERS,
params={
"page": 1,
"pageSize": 100,
},
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 records (use page / pageSize to fetch further pages)
for row in result.get("data", []):
print(row.get("url"), (row.get("content") or "")[:60])
示意回應樣本
以下為人工撰寫的示意資料:帳號為 sample_user_n,ID 為明顯的假值。欄位依 2026-10-25 規格快照;樣本只呈現部分欄位,完整清單見上方表格。
任務狀態為 DONE 後的輪詢回應(示意資料)
{
"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
}
]
}
限制與注意事項
- 搜尋結果每頁最多讀取 100 筆。
- start_date 與 end_date(YYYY-MM-DD)界定爬取範圍。
- 搜尋可回溯的期間、筆記數量與更新頻率,依專案範圍確認。
蒐集方式:以網路爬蟲蒐集各平台公開發布的內容。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。
更多 小紅書 API 頁面
申請試用
填寫下方申請表單時,請註明小紅書,並說明要搜尋的關鍵字或品類、是否需要留言與第二層回覆,以及預估資料量。我們會確認範圍,並回覆試用與 API 金鑰的安排。
填寫表單申請試用,專人確認範圍後回覆試用與介接安排。
填寫申請表單常見問題
- RedNote 和小紅書是同一個平台嗎?
- 是。小紅書(簡體中文寫作「小红书」)是這個 App 的中文名稱,許多國際使用者稱它為 RedNote。本 API 涵蓋在小紅書公開發布的筆記,所有路徑都使用 xhs 前綴。
- 可以指定日期區間搜尋筆記嗎?
- 建立搜尋任務時帶 start_date 與 end_date(YYYY-MM-DD);可回溯多遠依專案範圍確認。
- 可以取得搜尋到的筆記底下的留言嗎?
- 可以。把每則筆記的網址交給 POST /xhs/pushs/task;詳見小紅書留言 API。
- 資料是怎麼蒐集的?這是小紅書官方的 API 嗎?
- 資料以網路爬蟲蒐集小紅書公開發布的內容。LargitData 與小紅書沒有隸屬或合作關係,這也不是小紅書自身提供的 API。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。