XHS（小红書）使用ガイド

TikHub OpenAPI（https://api.tikhub.io）に基づいて整理した小紅書のAPIドキュメント。

1. 単一ノート
- 1.1 画像ノート（図文ノート）
- 1.2 動画ノート
2. ユーザー情報
3. ユーザー作品
4. コメント
- 4.1 一次コメント
- 4.2 二次コメント（子コメント）
5. 検索
- 5.1 ノート検索
- 5.2 ユーザー検索
6. 話題
- 6.1 話題詳細
- 6.2 話題ノート一覧

共通説明

a. 呼び出し戦略：複数シリーズの組み合わせ利用（重要）

小紅書のAPIで現在最も安定しているのは App V2 シリーズです。すべてのユーザーに対して「メインシリーズ + 1〜2 個の予備シリーズ」を組み合わせる戦略を強く推奨します。2〜3 個のシリーズを組み合わせて使うことで、全体の業務可用性を高められます。

b. 呼び出し優先順位：App V2（推奨）> App V1（フォールバック）> Web V3（第3候補）

App V2 が主推奨シリーズで、現時点で最も安定しており、データも最も完全です。最優先での利用を推奨します。App V1 は App V2 とフィールドの整合性が近く、第一予備のフォールバックとして適しています。Web V3 は企業ユーザー向けに開放された第3候補の Web 端末チャネルで、xsec_token（共有リンクから抽出可能）が必要です。ただし返却されるデータの次元は App V2 / App V1 より少ないため、企業ユーザーであっても複数シリーズを適切に組み合わせて使うことを推奨します。Web V3 のみを使うのは避けてください。Web V2 / Web シリーズ は一部のAPIしか利用できず、安定性も必ずしも保証されないため、主力としては推奨しません。前述の3シリーズで要件を満たせない場合の補助としてのみ利用してください。

c. 一言アドバイス：1つのシリーズだけに依存しないでください。本番環境では少なくとも2シリーズを主従構成で用意することを推奨します。企業ユーザーが Web V3 を使う場合は、データ次元を補うために App V2 / App V1 を追加で組み合わせてください。

d. 返却フィールドの注意：App 系 API（App V2 / App V1）同士は構造が似ており、フィールド名も基本的に対応付け可能です。ただし Web 系 API（Web V3 / Web V2 / Web）の返却 JSON 構造はそれぞれ異なり、フィールド名、ネスト階層、データ次元が異なる場合があります。利用時は必ず各APIの実際の返却 JSON フィールドを確認してから、解析・マッピングを行ってください。

1. 単一ノート

小紅書のノートは2種類に分かれます：図文ノート（画像ノート） と 動画ノート。App V2 シリーズでは2種類それぞれに独立したエンドポイントがあり、データが最も完全です。Web V3 は同一APIで両タイプを処理し、レスポンスフィールドで区別します。

共通の推奨：まず App V2 シリーズを優先してください。企業ユーザーは xsec_token を取得できる場面では Web V3 と組み合わせて利用できます。

総合例：3シリーズを組み合わせて単一ノート詳細を取得

以下は、メインシリーズ（App V2）→ 予備1（App V1）→ 予備2（Web V3） の組み合わせ呼び出しの考え方を示すサンプルコードです。優先順位に従って順番に試し、前のものが成功したらそのまま返し、失敗したら次へフォールバックします。

python
import requests

BASE_URL = "https://api.tikhub.io"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "accept": "application/json",
}

NOTE_ID = "697c0eee000000000a03c308"
XSEC_TOKEN = "ABxxxxxxxxxxxxxx"   # Required for Web V3, extract from share link / Web V3 需要，可从分享链接抽取
IS_VIDEO = False                  # Note type: True=video note, False=image note / 笔记类型：True=视频笔记，False=图文笔记


# --- Primary: App V2 / 主系列：App V2 ---
def fetch_by_app_v2(note_id: str, is_video: bool):
    if is_video:
        path = "/api/v1/xiaohongshu/app_v2/get_video_note_detail"
    else:
        path = "/api/v1/xiaohongshu/app_v2/get_image_note_detail"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS,
                        params={"note_id": note_id})


# --- Fallback 1: App V1 (image notes only; no video download URL, not recommended for videos) / 备用 1：App V1（仅图文有效，视频不含下载链接，不建议用于视频）---
def fetch_by_app_v1(note_id: str):
    path = "/api/v1/xiaohongshu/app/get_note_info"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS,
                        params={"note_id": note_id})


# --- Fallback 2: Web V3 (enterprise users only, requires xsec_token) / 备用 2：Web V3（企业用户专用，需要 xsec_token）---
def fetch_by_web_v3(note_id: str, xsec_token: str):
    path = "/api/v1/xiaohongshu/web_v3/fetch_note_detail"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS,
                        params={"note_id": note_id, "xsec_token": xsec_token})


# --- Try all three series in order / 三系列依次尝试 ---
def get_note_detail(note_id: str, xsec_token: str, is_video: bool):
    # 1) Primary: App V2 / 主系列：App V2
    try:
        r = fetch_by_app_v2(note_id, is_video)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v2", "data": r.json()}
    except Exception as e:
        print("App V2 调用失败：", e)

    # 2) Fallback 1: App V1 (skip this step for video notes) / 备用 1：App V1（视频笔记建议跳过此步）
    if not is_video:
        try:
            r = fetch_by_app_v1(note_id)
            if r.ok and r.json().get("code") == 200:
                return {"source": "app_v1", "data": r.json()}
        except Exception as e:
            print("App V1 调用失败：", e)

    # 3) Fallback 2: Web V3 / 备用 2：Web V3
    try:
        r = fetch_by_web_v3(note_id, xsec_token)
        if r.ok and r.json().get("code") == 200:
            return {"source": "web_v3", "data": r.json()}
    except Exception as e:
        print("Web V3 调用失败：", e)

    return None


result = get_note_detail(NOTE_ID, XSEC_TOKEN, IS_VIDEO)
print(result)

補足：上記の成功判定（code == 200）は説明用の書き方です。実際には各シリーズの返却JSONフィールドに基づいて判定してください。シリーズごとに返却構造が異なるため、各シリーズごとに個別の解析ロジックを実装することを推奨します。

1.1 画像ノート（図文ノート）

1.1.1 [App V2] 図文ノート詳細を取得 ⭐ 推奨

図文ノートの完全な詳細データ（画像URL、タイトル、本文、タグ、インタラクションデータなど）を取得します。

方法：GET
パス：/api/v1/xiaohongshu/app_v2/get_image_note_detail
公式ドキュメント：docs.tikhub.io/420136391e0
パラメータ：
- note_id (string, 任意)：ノートID、例："697c0eee000000000a03c308"
- share_text (string, 任意)：小紅書の共有リンク（APP / Web 端末対応）
- どちらか一方を指定。優先は note_id。両方指定した場合は note_id を優先

python
import requests

BASE_URL = "https://api.tikhub.io"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

url = f"{BASE_URL}/api/v1/xiaohongshu/app_v2/get_image_note_detail"
params = {
    "note_id": "697c0eee000000000a03c308",
    # "share_text": "https://www.xiaohongshu.com/discovery/item/...",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

1.1.2 [App V1] ノート情報を取得 V1（図文のみ、動画ダウンロードリンクなし）

App V1 のノートAPIは、図文ノートのみに対応します。返却内容に動画ダウンロードリンクは含まれないため、動画ノートには使用しないでください。動画ノートは App V2 の get_video_note_detail を使用してください。

方法：GET
パス：/api/v1/xiaohongshu/app/get_note_info
公式ドキュメント：docs.tikhub.io/310965839e0
パラメータ：
- note_id (string, 任意)
- share_text (string, 任意)
- どちらか一方を指定。優先は note_id

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app/get_note_info"
params = {
    "note_id": "697c0eee000000000a03c308",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

1.1.3 [Web V3] ノート詳細を取得（図文/動画共通）

Web V3 のエンドポイントで、図文/動画共通です。xsec_token（共有リンクから抽出、上記「補助ツールAPI」を参照）が必要です。

方法：GET
パス：/api/v1/xiaohongshu/web_v3/fetch_note_detail
公式ドキュメント：docs.tikhub.io/438852168e0
パラメータ：
- note_id (string, 必須)
- xsec_token (string, 必須)

python
url = f"{BASE_URL}/api/v1/xiaohongshu/web_v3/fetch_note_detail"
params = {
    "note_id": "697c0eee000000000a03c308",
    "xsec_token": "ABxxxxxxxxxxxxxx",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

1.2 動画ノート

動画ノートには App V1 の get_note_info を使用しないでください。このAPIの返却内容には動画ダウンロードリンクが含まれません。以下の App V2 または Web V3 を使用してください。

1.2.1 [App V2] 動画ノート詳細を取得 ⭐ 推奨

動画ノートの完全な詳細データ（動画URL、カバー、長さ、タイトル、本文、インタラクションデータなど）を取得します。

方法：GET
パス：/api/v1/xiaohongshu/app_v2/get_video_note_detail
公式ドキュメント：docs.tikhub.io/420136392e0
パラメータ：
- note_id (string, 任意)：例："697c0eee000000000a03c308"
- share_text (string, 任意)
- どちらか一方を指定。優先は note_id

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app_v2/get_video_note_detail"
params = {
    "note_id": "697c0eee000000000a03c308",
    # "share_text": "https://www.xiaohongshu.com/discovery/item/...",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

1.2.2 [Web V3] ノート詳細を取得（動画共通）

図文と同じエンドポイントで、note_id + xsec_token を指定して呼び出せばOKです。

方法：GET
パス：/api/v1/xiaohongshu/web_v3/fetch_note_detail
公式ドキュメント：docs.tikhub.io/438852168e0

python
url = f"{BASE_URL}/api/v1/xiaohongshu/web_v3/fetch_note_detail"
params = {
    "note_id": "697c0eee000000000a03c308",
    "xsec_token": "ABxxxxxxxxxxxxxx",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

2. ユーザー情報

user_id を通じて、小紅書ユーザーの公開プロフィール（ニックネーム、アバター、自己紹介、フォロワー数、フォロー数、ノート数など）を取得します。3シリーズすべてにユーザー情報APIがあります。App V2 のフィールドが最も充実しており、App V1 / Web V3 は予備として適しています。

共通の推奨：まず App V2 シリーズを優先してください。user_id のみ取得できる場合でも App V1 / Web V3 を利用できます。

💡 user_id の取得方法が分からない？ まず /api/v1/xiaohongshu/app/get_user_id_and_xsec_token という補助ツールAPI（公式ドキュメント）を使い、任意の小紅書ユーザープロフィール共有リンク（長リンク/短リンクどちらでも可）を渡すと、user_id と xsec_token を解析できます。その後、下記のユーザー情報APIに渡してください。詳細は下の 2.3 を参照してください。

総合例：3シリーズを組み合わせてユーザー情報を取得

python
import requests

BASE_URL = "https://api.tikhub.io"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "accept": "application/json",
}

USER_ID = "61b46d790000000010008153"


# --- Primary: App V2 / 主系列：App V2 ---
def fetch_user_by_app_v2(user_id: str):
    path = "/api/v1/xiaohongshu/app_v2/get_user_info"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS,
                        params={"user_id": user_id})


# --- Fallback 1: App V1 / 备用 1：App V1 ---
def fetch_user_by_app_v1(user_id: str):
    path = "/api/v1/xiaohongshu/app/get_user_info"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS,
                        params={"user_id": user_id})


# --- Fallback 2: Web V3 / 备用 2：Web V3 ---
def fetch_user_by_web_v3(user_id: str):
    path = "/api/v1/xiaohongshu/web_v3/fetch_user_info"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS,
                        params={"user_id": user_id})


# --- Try all three series in order / 三系列依次尝试 ---
def get_user_info(user_id: str):
    # 1) Primary: App V2 / 主系列：App V2
    try:
        r = fetch_user_by_app_v2(user_id)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v2", "data": r.json()}
    except Exception as e:
        print("App V2 调用失败：", e)

    # 2) Fallback 1: App V1 / 备用 1：App V1
    try:
        r = fetch_user_by_app_v1(user_id)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v1", "data": r.json()}
    except Exception as e:
        print("App V1 调用失败：", e)

    # 3) Fallback 2: Web V3 / 备用 2：Web V3
    try:
        r = fetch_user_by_web_v3(user_id)
        if r.ok and r.json().get("code") == 200:
            return {"source": "web_v3", "data": r.json()}
    except Exception as e:
        print("Web V3 调用失败：", e)

    return None


result = get_user_info(USER_ID)
print(result)

補足：上記の成功判定（code == 200）は説明用の書き方です。実際には各シリーズの返却JSONフィールドに基づいて判定してください。シリーズごとに返却構造が異なるため、各シリーズごとに個別の解析ロジックを実装することを推奨します。

2.1 [App V2] ユーザー情報を取得 ⭐ 推奨

指定ユーザーの詳細情報を取得します。ニックネーム、アバター、自己紹介、フォロワー数、フォロー数、ノート数などを含みます。

方法：GET
パス：/api/v1/xiaohongshu/app_v2/get_user_info
公式ドキュメント：docs.tikhub.io/420136395e0
パラメータ：
- user_id (string, 任意)：ユーザーID、例："61b46d790000000010008153"
- share_text (string, 任意)：小紅書ユーザーの共有リンク（APP / Web 端末対応）
- どちらか一方を指定。優先は user_id。両方指定した場合は user_id を優先

python
import requests

BASE_URL = "https://api.tikhub.io"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

url = f"{BASE_URL}/api/v1/xiaohongshu/app_v2/get_user_info"
params = {
    "user_id": "61b46d790000000010008153",
    # "share_text": "https://www.xiaohongshu.com/user/profile/...",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

2.2 [App V1] ユーザー情報を取得

App V1 のユーザー情報APIです。

方法：GET
パス：/api/v1/xiaohongshu/app/get_user_info
公式ドキュメント：docs.tikhub.io/310965845e0
パラメータ：
- user_id (string, 必須)

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app/get_user_info"
params = {
    "user_id": "61b46d790000000010008153",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

2.3 [App V1] 補助ツール：ユーザー共有リンクから user_id と xsec_token を抽出

手元にユーザープロフィール共有リンクしかない場合（長リンク/短リンク両対応）、まずこのAPIで user_id と xsec_token を解析し、その後で上記のユーザー情報APIを呼び出してください。

方法：GET
パス：/api/v1/xiaohongshu/app/get_user_id_and_xsec_token
公式ドキュメント：docs.tikhub.io/364605901e0
パラメータ：
- share_link (string, 必須)：小紅書ユーザーの共有リンク

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app/get_user_id_and_xsec_token"
params = {
    "share_link": "https://xhslink.com/m/xxxxx",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())
# Example response fields / 返回示例字段:
# {
#   "data": {
#       "user_id": "61b46d790000000010008153",
#       "xsec_token": "ABxxxxxxxxxxxxxx"
#   }
# }

2.4 [Web V3] ユーザー情報を取得

Web V3 のユーザー公開プロフィールAPIです。user_id だけで利用できます。

方法：GET
パス：/api/v1/xiaohongshu/web_v3/fetch_user_info
公式ドキュメント：docs.tikhub.io/438852177e0
パラメータ：
- user_id (string, 必須)

python
url = f"{BASE_URL}/api/v1/xiaohongshu/web_v3/fetch_user_info"
params = {
    "user_id": "61b46d790000000010008153",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

3. ユーザー作品

user_id に基づいて、そのユーザーが投稿したノート一覧（図文/動画混在）を取得します。すべてのAPIはカーソルページネーション（cursor）を使用します。App V2 シリーズでは追加で「ユーザーの公開お気に入りノート一覧」API（faved notes）も提供されます。App V1 / Web V3 は「公開済みノート」のみを対象とします。

共通の推奨：まず App V2 シリーズを優先してください。user_id のみ取得できる場合でも App V1 / Web V3 を利用できます。

💡 user_id の取得方法が分からない？上記 2.3 の補助ツールAPI（公式ドキュメント）を参照してください。

総合例：3シリーズを組み合わせてユーザーの公開ノートを取得

python
import requests

BASE_URL = "https://api.tikhub.io"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "accept": "application/json",
}

USER_ID = "61b46d790000000010008153"
CURSOR = ""   # Empty for first request; pass previous response's cursor for pagination / 首次请求留空；翻页时传上一次返回的 cursor


# --- Primary: App V2 / 主系列：App V2 ---
def fetch_user_notes_app_v2(user_id: str, cursor: str = ""):
    path = "/api/v1/xiaohongshu/app_v2/get_user_posted_notes"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS,
                        params={"user_id": user_id, "cursor": cursor})


# --- Fallback 1: App V1 / 备用 1：App V1 ---
def fetch_user_notes_app_v1(user_id: str, cursor: str = ""):
    path = "/api/v1/xiaohongshu/app/get_user_notes"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS,
                        params={"user_id": user_id, "cursor": cursor})


# --- Fallback 2: Web V3 / 备用 2：Web V3 ---
def fetch_user_notes_web_v3(user_id: str, cursor: str = "", num: int = 30):
    path = "/api/v1/xiaohongshu/web_v3/fetch_user_notes"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS,
                        params={"user_id": user_id, "cursor": cursor, "num": num})


# --- Try all three series in order / 三系列依次尝试 ---
def get_user_notes(user_id: str, cursor: str = ""):
    # 1) Primary: App V2 / 主系列：App V2
    try:
        r = fetch_user_notes_app_v2(user_id, cursor)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v2", "data": r.json()}
    except Exception as e:
        print("App V2 调用失败：", e)

    # 2) Fallback 1: App V1 / 备用 1：App V1
    try:
        r = fetch_user_notes_app_v1(user_id, cursor)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v1", "data": r.json()}
    except Exception as e:
        print("App V1 调用失败：", e)

    # 3) Fallback 2: Web V3 / 备用 2：Web V3
    try:
        r = fetch_user_notes_web_v3(user_id, cursor)
        if r.ok and r.json().get("code") == 200:
            return {"source": "web_v3", "data": r.json()}
    except Exception as e:
        print("Web V3 调用失败：", e)

    return None


result = get_user_notes(USER_ID, CURSOR)
print(result)

補足：上記の成功判定（code == 200）は説明用の書き方です。実際には各シリーズの返却JSONフィールドに基づいて判定してください。シリーズごとに返却構造が異なるため、各シリーズごとに個別の解析ロジックを実装することを推奨します。

3.1 [App V2] ユーザーの公開ノート一覧を取得 ⭐ 推奨

指定ユーザーが公開したノート一覧を取得します。カーソルページネーションを使用します。

方法：GET
パス：/api/v1/xiaohongshu/app_v2/get_user_posted_notes
公式ドキュメント：docs.tikhub.io/420136396e0
パラメータ：
- user_id (string, 任意)：ユーザーID、例："61b46d790000000010008153"
- share_text (string, 任意)：小紅書ユーザーの共有リンク（APP / Web 端末対応）
- どちらか一方を指定。優先は user_id。両方指定した場合は user_id を優先
- cursor (string, 任意)：ページングカーソル。初回リクエストでは空欄。ページ送り時は前回レスポンス中の notes リストの最後のノートの cursor を取得（パス例：$.data.data.notes[-1].cursor）

python
import requests

BASE_URL = "https://api.tikhub.io"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

url = f"{BASE_URL}/api/v1/xiaohongshu/app_v2/get_user_posted_notes"
params = {
    "user_id": "61b46d790000000010008153",
    "cursor": "",   # Empty for first request / 首次留空
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

3.2 [App V2] ユーザーの公開お気に入りノート一覧を取得（App V2 のみ）

指定ユーザーが公開お気に入りしたノート一覧を取得します（ユーザー自身が投稿したものではなく、ta がお気に入り登録したコンテンツ）。カーソルページネーションを使用します。このAPIはApp V2 のみ提供され、App V1 / Web V3 には対応機能がありません。

方法：GET
パス：/api/v1/xiaohongshu/app_v2/get_user_faved_notes
公式ドキュメント：docs.tikhub.io/420136397e0
パラメータ：
- user_id (string, 任意)：例："5a8cf39111be10466d285d6b"
- share_text (string, 任意)
- どちらか一方を指定。優先は user_id
- cursor (string, 任意)：ページングカーソル。初回は空欄。ページ送り時は前ページの最後のノートの note_id を渡す

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app_v2/get_user_faved_notes"
params = {
    "user_id": "5a8cf39111be10466d285d6b",
    "cursor": "",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

3.3 [App V1] ユーザー作品一覧を取得

App V1 のユーザー作品APIです。公開済みノートのみを対象とし、カーソルページネーションを使用します。

方法：GET
パス：/api/v1/xiaohongshu/app/get_user_notes
公式ドキュメント：docs.tikhub.io/310965846e0
パラメータ：
- user_id (string, 必須)
- cursor (string, 任意)：初回は空欄。ページ送り時は前ページの notes リストの最後のノートの note_id を取得

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app/get_user_notes"
params = {
    "user_id": "61b46d790000000010008153",
    "cursor": "",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

返却構造（主要フィールド）：

notes[]：ノート配列。各項目には note_id、type（normal=図文 / video=動画）、display_title、desc、liked_count、cover、user などを含む
cursor：次ページのカーソル
has_more：さらにデータがあるかどうか

3.4 [Web V3] ユーザーノート一覧を取得

Web V3 のユーザー作品APIです。カーソルページネーションを使用し、1ページあたりの件数を指定できます（最大 30）。

方法：GET
パス：/api/v1/xiaohongshu/web_v3/fetch_user_notes
公式ドキュメント：docs.tikhub.io/438852178e0
パラメータ：
- user_id (string, 必須)
- cursor (string, 任意)：ページングカーソル
- num (integer, 任意)：1ページあたりの件数。デフォルト 30、最大 30

python
url = f"{BASE_URL}/api/v1/xiaohongshu/web_v3/fetch_user_notes"
params = {
    "user_id": "61b46d790000000010008153",
    "cursor": "",
    "num": 30,
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

4. コメント

小紅書のコメントは2層に分かれます：一次コメント（ノート下のコメント一覧） と 二次コメント（特定コメントへの返信/子コメント一覧）。3シリーズすべてにこの2層のAPIがあります。App V2 のフィールドが最も豊富で、App V1 / Web V3 は予備として適しています。

共通の推奨：まず App V2 シリーズを優先してください。Web V3 のAPIには xsec_token が必要です（共有リンクから抽出可能。上記 1. 単一ノート の総合例 / 2.3 の補助ツールAPIを参照）。

4.1 一次コメント（ノート下のコメント一覧）

総合例：3シリーズを組み合わせて一次コメントを取得

以下は、メインシリーズ（App V2）→ 予備1（App V1）→ 予備2（Web V3） の組み合わせ呼び出しの考え方を示すサンプルコードです。

python
import requests

BASE_URL = "https://api.tikhub.io"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "accept": "application/json",
}

NOTE_ID = "697c0eee000000000a03c308"
XSEC_TOKEN = "ABxxxxxxxxxxxxxx"   # Required for Web V3 / Web V3 需要


# --- Primary: App V2 / 主系列：App V2 ---
def fetch_comments_app_v2(note_id: str, cursor: str = "", index: int = 0):
    path = "/api/v1/xiaohongshu/app_v2/get_note_comments"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "note_id": note_id,
        "cursor": cursor,
        "index": index,
        "pageArea": "UNFOLDED",
        "sort_strategy": "latest_v2",
    })


# --- Fallback 1: App V1 / 备用 1：App V1 ---
def fetch_comments_app_v1(note_id: str, start: str = ""):
    path = "/api/v1/xiaohongshu/app/get_note_comments"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "note_id": note_id,
        "start": start,
        "sort_strategy": 1,
    })


# --- Fallback 2: Web V3 / 备用 2：Web V3 ---
def fetch_comments_web_v3(note_id: str, xsec_token: str, cursor: str = ""):
    path = "/api/v1/xiaohongshu/web_v3/fetch_note_comments"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "note_id": note_id,
        "xsec_token": xsec_token,
        "cursor": cursor,
    })


# --- Try all three series in order / 三系列依次尝试 ---
def get_note_comments(note_id: str, xsec_token: str):
    try:
        r = fetch_comments_app_v2(note_id)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v2", "data": r.json()}
    except Exception as e:
        print("App V2 调用失败：", e)

    try:
        r = fetch_comments_app_v1(note_id)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v1", "data": r.json()}
    except Exception as e:
        print("App V1 调用失败：", e)

    try:
        r = fetch_comments_web_v3(note_id, xsec_token)
        if r.ok and r.json().get("code") == 200:
            return {"source": "web_v3", "data": r.json()}
    except Exception as e:
        print("Web V3 调用失败：", e)

    return None


result = get_note_comments(NOTE_ID, XSEC_TOKEN)
print(result)

補足：上記の成功判定（code == 200）は説明用の書き方です。実際には各シリーズの返却JSONフィールドに基づいて判定してください。

4.1.1 [App V2] ノートコメント一覧を取得 ⭐ 推奨

方法：GET
パス：/api/v1/xiaohongshu/app_v2/get_note_comments
公式ドキュメント：docs.tikhub.io/420136394e0
パラメータ：
- note_id (string, 任意)：ノートID
- share_text (string, 任意)：共有リンク（note_id とどちらか一方。優先は note_id）
- cursor (string, 任意)：ページングカーソル。初回は空欄
- index (integer, 任意)：コメントインデックス。初回は 0 を指定
- pageArea (string, 任意)：折りたたみ状態、UNFOLDED（デフォルト）/ FOLDED
- sort_strategy (string, 任意)：並び順、default / latest_v2（デフォルト） / like_count

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app_v2/get_note_comments"
params = {
    "note_id": "697c0eee000000000a03c308",
    "cursor": "",
    "index": 0,
    "pageArea": "UNFOLDED",
    "sort_strategy": "latest_v2",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

4.1.2 [App V1] ノートコメントを取得

方法：GET
パス：/api/v1/xiaohongshu/app/get_note_comments
公式ドキュメント：docs.tikhub.io/310965840e0
パラメータ：
- note_id (string, 必須)
- start (string, 任意)：ページングカーソル。初回は空欄。2つの形式に対応 —— シンプル形式（例："682b0133000000001c03618d"）、または JSON 形式（例：{"cursor":"...","index":2,"pageArea":"UNFOLDED"}）
- sort_strategy (integer, 任意)：1-デフォルト並び順（デフォルト）/ 2-最新コメント

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app/get_note_comments"
params = {
    "note_id": "697c0eee000000000a03c308",
    "start": "",
    "sort_strategy": 1,
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

4.1.3 [Web V3] ノートコメントを取得

方法：GET
パス：/api/v1/xiaohongshu/web_v3/fetch_note_comments
公式ドキュメント：docs.tikhub.io/438852169e0
パラメータ：
- note_id (string, 必須)
- xsec_token (string, 必須)：共有リンクから抽出可能
- cursor (string, 任意)：ページングカーソル

python
url = f"{BASE_URL}/api/v1/xiaohongshu/web_v3/fetch_note_comments"
params = {
    "note_id": "697c0eee000000000a03c308",
    "xsec_token": "ABxxxxxxxxxxxxxx",
    "cursor": "",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

4.2 二次コメント（子コメント / 返信一覧）

特定の一次コメント下にあるすべての返信（子コメント）を取得します。こちらも3シリーズで対応しています。なお、Web V3 ではこのパラメータ名は root_comment_id、他の2シリーズでは comment_id です。

総合例：3シリーズを組み合わせて子コメントを取得

python
import requests

BASE_URL = "https://api.tikhub.io"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "accept": "application/json",
}

NOTE_ID = "699916e6000000001d0253da"
COMMENT_ID = "PARENT_COMMENT_ID"  # Top-level comment ID / 一级评论 ID
XSEC_TOKEN = "ABxxxxxxxxxxxxxx"   # Required for Web V3 / Web V3 需要


def fetch_sub_app_v2(note_id, comment_id, cursor="", index=1):
    path = "/api/v1/xiaohongshu/app_v2/get_note_sub_comments"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "note_id": note_id,
        "comment_id": comment_id,
        "cursor": cursor,
        "index": index,
    })


def fetch_sub_app_v1(note_id, comment_id, start=""):
    path = "/api/v1/xiaohongshu/app/get_sub_comments"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "note_id": note_id,
        "comment_id": comment_id,
        "start": start,
    })


def fetch_sub_web_v3(note_id, root_comment_id, xsec_token, cursor="", num=10):
    path = "/api/v1/xiaohongshu/web_v3/fetch_sub_comments"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "note_id": note_id,
        "root_comment_id": root_comment_id,
        "xsec_token": xsec_token,
        "cursor": cursor,
        "num": num,
    })


def get_sub_comments(note_id, comment_id, xsec_token):
    try:
        r = fetch_sub_app_v2(note_id, comment_id)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v2", "data": r.json()}
    except Exception as e:
        print("App V2 调用失败：", e)

    try:
        r = fetch_sub_app_v1(note_id, comment_id)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v1", "data": r.json()}
    except Exception as e:
        print("App V1 调用失败：", e)

    try:
        r = fetch_sub_web_v3(note_id, comment_id, xsec_token)
        if r.ok and r.json().get("code") == 200:
            return {"source": "web_v3", "data": r.json()}
    except Exception as e:
        print("Web V3 调用失败：", e)

    return None


result = get_sub_comments(NOTE_ID, COMMENT_ID, XSEC_TOKEN)
print(result)

4.2.1 [App V2] ノート二次コメント一覧を取得 ⭐ 推奨

方法：GET
パス：/api/v1/xiaohongshu/app_v2/get_note_sub_comments
公式ドキュメント：docs.tikhub.io/420748830e0
パラメータ：
- note_id (string, 任意)
- share_text (string, 任意)（note_id とどちらか一方。優先は note_id）
- comment_id (string, 必須)：親コメントID
- cursor (string, 任意)：初回は空欄。ページ送り時は $.data.cursor から取得
- index (integer, 任意)：初回は 1 を指定。ページ送り時は $.data.cursor から取得

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app_v2/get_note_sub_comments"
params = {
    "note_id": "699916e6000000001d0253da",
    "comment_id": "PARENT_COMMENT_ID",
    "cursor": "",
    "index": 1,
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

4.2.2 [App V1] 子コメントを取得

方法：GET
パス：/api/v1/xiaohongshu/app/get_sub_comments
公式ドキュメント：docs.tikhub.io/310965841e0
パラメータ：
- note_id (string, 必須)
- comment_id (string, 必須)：一次コメントID
- start (string, 任意)：ページングカーソル。前ページの最後の子コメントIDから取得（例："6806642d000000001f01991b"）

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app/get_sub_comments"
params = {
    "note_id": "697c0eee000000000a03c308",
    "comment_id": "PARENT_COMMENT_ID",
    "start": "",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

4.2.3 [Web V3] 子コメントを取得

方法：GET
パス：/api/v1/xiaohongshu/web_v3/fetch_sub_comments
公式ドキュメント：docs.tikhub.io/438852170e0
パラメータ：
- note_id (string, 必須)
- root_comment_id (string, 必須)：親コメントID
- xsec_token (string, 必須)
- num (integer, 任意)：返却件数、デフォルト 10
- cursor (string, 任意)：ページングカーソル

python
url = f"{BASE_URL}/api/v1/xiaohongshu/web_v3/fetch_sub_comments"
params = {
    "note_id": "697c0eee000000000a03c308",
    "root_comment_id": "PARENT_COMMENT_ID",
    "xsec_token": "ABxxxxxxxxxxxxxx",
    "num": 10,
    "cursor": "",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

5. 検索

小紅書の検索は2種類に分かれます：ノート検索 と ユーザー検索。

ノート検索：App V2 / App V1 / Web V3 の3シリーズすべてで提供されます。App V2 のフィールドが最も豊富です（並び順、ノート種別、期間フィルタ、AIモードなどに対応）。
ユーザー検索：App V2 と Web V3 のみ提供され、App V1 にはユーザー検索APIがありません。

共通の推奨：まず App V2 シリーズを優先してください。ページ送り時は初回検索で返された search_id / session_id を忘れずに付与してください（シリーズごとにパラメータ名が少し異なります）。

5.1 ノート検索

総合例：3シリーズを組み合わせてノートを検索

以下は、メインシリーズ（App V2）→ 予備1（App V1）→ 予備2（Web V3） の組み合わせ呼び出しの考え方を示すサンプルコードです。

python
import requests

BASE_URL = "https://api.tikhub.io"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "accept": "application/json",
}

KEYWORD = "美食推荐"
PAGE = 1


# --- Primary: App V2 / 主系列：App V2 ---
def search_notes_app_v2(keyword: str, page: int = 1):
    path = "/api/v1/xiaohongshu/app_v2/search_notes"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "keyword": keyword,
        "page": page,
        "sort_type": "general",
        "note_type": "不限",
        "time_filter": "不限",
    })


# --- Fallback 1: App V1 / 备用 1：App V1 ---
def search_notes_app_v1(keyword: str, page: int = 1):
    path = "/api/v1/xiaohongshu/app/search_notes"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "keyword": keyword,
        "page": page,
        "sort_type": "general",
        "filter_note_type": "不限",
        "filter_note_time": "不限",
    })


# --- Fallback 2: Web V3 / 备用 2：Web V3 ---
def search_notes_web_v3(keyword: str, page: int = 1):
    path = "/api/v1/xiaohongshu/web_v3/fetch_search_notes"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "keyword": keyword,
        "page": page,
        "sort": "general",
        "note_type": 0,
    })


def search_notes(keyword: str, page: int = 1):
    try:
        r = search_notes_app_v2(keyword, page)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v2", "data": r.json()}
    except Exception as e:
        print("App V2 调用失败：", e)

    try:
        r = search_notes_app_v1(keyword, page)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v1", "data": r.json()}
    except Exception as e:
        print("App V1 调用失败：", e)

    try:
        r = search_notes_web_v3(keyword, page)
        if r.ok and r.json().get("code") == 200:
            return {"source": "web_v3", "data": r.json()}
    except Exception as e:
        print("Web V3 调用失败：", e)

    return None


result = search_notes(KEYWORD, PAGE)
print(result)

補足：上記の成功判定（code == 200）は説明用の書き方です。実際には各シリーズの返却JSONフィールドに基づいて判定してください。ページ送り時は、初回レスポンス内の search_id / session_id をそのまま返却先に渡すことを忘れないでください。

5.1.1 [App V2] ノート検索 ⭐ 推奨

方法：GET
パス：/api/v1/xiaohongshu/app_v2/search_notes
公式ドキュメント：docs.tikhub.io/420136398e0
パラメータ：
- keyword (string, 必須)：検索キーワード、例："美食推荐"
- page (integer, 任意)：ページ番号、1 から開始
- sort_type (string, 任意)：並び順、general（総合、デフォルト）/ time_descending（最新）/ popularity_descending（いいね数が多い）/ comment_descending（コメント数が多い）/ collect_descending（お気に入り数が多い）/ english_preferred（英語優先）
- note_type (string, 任意)：ノート種別、不限（デフォルト）/ 视频笔记 / 普通笔记 / 直播笔记
- time_filter (string, 任意)：投稿時期、不限（デフォルト）/ 一天内 / 一周内 / 半年内
- search_id (string, 任意)：ページ送り時は初回レスポンスの値を渡す
- search_session_id (string, 任意)：ページ送り時は初回レスポンスの値を渡す
- source (string, 任意)：ソース、デフォルト explore_feed
- ai_mode (integer, 任意)：AIモード、0（オフ、デフォルト）/ 1（オン）

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app_v2/search_notes"
params = {
    "keyword": "美食推荐",
    "page": 1,
    "sort_type": "general",
    "note_type": "不限",
    "time_filter": "不限",
    # Pass search_id and search_session_id from first response for pagination / 翻页时需要带上首次响应里的 search_id 和 search_session_id
    # "search_id": "...",
    # "search_session_id": "...",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

5.1.2 [App V1] ノート検索

方法：GET
パス：/api/v1/xiaohongshu/app/search_notes
公式ドキュメント：docs.tikhub.io/310965843e0
パラメータ：
- keyword (string, 必須)
- page (integer, 必須)：ページ番号、1 から開始
- search_id (string, 任意)：ページ送り時は初回レスポンスの値を渡す
- session_id (string, 任意)：ページ送り時は初回レスポンスの値を渡す
- sort_type (string, 任意)：general（デフォルト）/ time_descending / popularity_descending / comment_descending / collect_descending
- filter_note_type (string, 任意)：不限（デフォルト）/ 视频笔记 / 普通笔记
- filter_note_time (string, 任意)：不限（デフォルト）/ 一天内 / 一周内 / 半年内

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app/search_notes"
params = {
    "keyword": "美食推荐",
    "page": 1,
    "sort_type": "general",
    "filter_note_type": "不限",
    "filter_note_time": "不限",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

5.1.3 [Web V3] ノート検索

方法：GET
パス：/api/v1/xiaohongshu/web_v3/fetch_search_notes
公式ドキュメント：docs.tikhub.io/438852171e0
パラメータ：
- keyword (string, 必須)
- page (integer, 任意)：デフォルト 1
- sort (string, 任意)：general（総合、デフォルト）/ time_descending（最新）/ popularity_descending（人気順）
- note_type (integer, 任意)：0=すべて（デフォルト）/ 1=図文 / 2=動画

python
url = f"{BASE_URL}/api/v1/xiaohongshu/web_v3/fetch_search_notes"
params = {
    "keyword": "美食推荐",
    "page": 1,
    "sort": "general",
    "note_type": 0,
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

5.2 ユーザー検索

⚠️ 注意：App V1 にはユーザー検索APIがありません。本節は App V2 と Web V3 の2シリーズのみです。

総合例：2シリーズを組み合わせてユーザーを検索

python
import requests

BASE_URL = "https://api.tikhub.io"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "accept": "application/json",
}

KEYWORD = "美食博主"
PAGE = 1


# --- Primary: App V2 / 主系列：App V2 ---
def search_users_app_v2(keyword: str, page: int = 1, search_id: str = ""):
    path = "/api/v1/xiaohongshu/app_v2/search_users"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "keyword": keyword,
        "page": page,
        "search_id": search_id,
    })


# --- Fallback: Web V3 / 备用：Web V3 ---
def search_users_web_v3(keyword: str, page: int = 1):
    path = "/api/v1/xiaohongshu/web_v3/fetch_search_users"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "keyword": keyword,
        "page": page,
    })


def search_users(keyword: str, page: int = 1):
    try:
        r = search_users_app_v2(keyword, page)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v2", "data": r.json()}
    except Exception as e:
        print("App V2 调用失败：", e)

    try:
        r = search_users_web_v3(keyword, page)
        if r.ok and r.json().get("code") == 200:
            return {"source": "web_v3", "data": r.json()}
    except Exception as e:
        print("Web V3 调用失败：", e)

    return None


result = search_users(KEYWORD, PAGE)
print(result)

5.2.1 [App V2] ユーザー検索 ⭐ 推奨

1ページあたり固定で20件返却され、ページングに対応しています。

方法：GET
パス：/api/v1/xiaohongshu/app_v2/search_users
公式ドキュメント：docs.tikhub.io/420136399e0
パラメータ：
- keyword (string, 必須)：検索キーワード、例："美食博主"
- page (integer, 任意)：ページ番号、1 から開始
- search_id (string, 任意)：ページ送り時は初回レスポンスの値を渡す
- source (string, 任意)：ソース、デフォルト explore_feed

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app_v2/search_users"
params = {
    "keyword": "美食博主",
    "page": 1,
    # Pass search_id from first response for pagination / 翻页时带上首次响应里的 search_id
    # "search_id": "...",
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

5.2.2 [Web V3] ユーザー検索

方法：GET
パス：/api/v1/xiaohongshu/web_v3/fetch_search_users
公式ドキュメント：docs.tikhub.io/438852172e0
パラメータ：
- keyword (string, 必須)
- page (integer, 任意)：デフォルト 1

python
url = f"{BASE_URL}/api/v1/xiaohongshu/web_v3/fetch_search_users"
params = {
    "keyword": "口红",
    "page": 1,
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())

6. 話題

小紅書の話題関連APIは2つに分かれます：話題詳細 と 話題下のノート一覧。

⚠️ 重要な注意：

Web V3 シリーズには話題APIがありません。本節は App V2 と App V1 の2シリーズのみです。

App V1 の旧API /api/v1/xiaohongshu/app/get_notes_by_topic は廃止済みです。本節の get_topic_notes を使用してください。

すべてのAPIは page_id（話題/ハッシュタグID）を一意識別子として使用します。

6.1 話題詳細

App V2 のみが話題詳細API（話題名、閲覧数、議論数、共有情報など）を提供します。App V1 / Web V3 には対応機能がありません。

6.1.1 [App V2] 話題詳細を取得 ⭐ App V2 のみ

方法：GET
パス：/api/v1/xiaohongshu/app_v2/get_topic_info
公式ドキュメント：docs.tikhub.io/420136407e0
パラメータ：
- page_id (string, 必須)：話題ページID、例："5c1cc866febed9000184b7c1"
- source (string, 任意)：ソース、デフォルト normal
- note_id (string, 任意)：ソースノートID。ノートから話題へ遷移する場合に指定可能

python
import requests

BASE_URL = "https://api.tikhub.io"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

url = f"{BASE_URL}/api/v1/xiaohongshu/app_v2/get_topic_info"
params = {
    "page_id": "5c1cc866febed9000184b7c1",
    "source": "normal",
    # "note_id": "...",  # Optional: pass when navigating from a note / 从笔记跳转过来时可带
}
r = requests.get(url, headers=HEADERS, params=params)
print(r.json())
# Response contains page_info (name/views/discussions), tabs, share_info, etc. / 返回包含 page_info（名称/浏览量/讨论数）、tabs、share_info 等

6.2 話題ノート一覧（話題下のノート）

特定の話題/ハッシュタグ下のノート一覧を取得します。App V2 と App V1 の両方が提供していますが、パラメータとページングフィールドに大きな差があるため、それぞれに合わせた実装が必要です。

総合例：2シリーズを組み合わせて話題ノートを取得

python
import requests
import time

BASE_URL = "https://api.tikhub.io"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "accept": "application/json",
}

PAGE_ID = "5c1cc866febed9000184b7c1"


# --- Primary: App V2 / 主系列：App V2 ---
def topic_feed_app_v2(page_id: str, sort: str = "trend"):
    path = "/api/v1/xiaohongshu/app_v2/get_topic_feed"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "page_id": page_id,
        "sort": sort,        # trend (hottest) / time (latest) | trend(最热) / time(最新)
    })


# --- Fallback: App V1 / 备用：App V1 ---
def topic_notes_app_v1(page_id: str, sort: str = "hot"):
    path = "/api/v1/xiaohongshu/app/get_topic_notes"
    return requests.get(f"{BASE_URL}{path}", headers=HEADERS, params={
        "page_id": page_id,
        "first_load_time": str(int(time.time() * 1000)),  # Millisecond timestamp / 毫秒级时间戳
        "sort": sort,        # hot (general) / time (latest) / trend (hottest) | hot(综合) / time(最新) / trend(最热)
    })


def get_topic_notes(page_id: str):
    try:
        r = topic_feed_app_v2(page_id)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v2", "data": r.json()}
    except Exception as e:
        print("App V2 调用失败：", e)

    try:
        r = topic_notes_app_v1(page_id)
        if r.ok and r.json().get("code") == 200:
            return {"source": "app_v1", "data": r.json()}
    except Exception as e:
        print("App V1 调用失败：", e)

    return None


result = get_topic_notes(PAGE_ID)
print(result)

補足：上記の成功判定（code == 200）は説明用の書き方です。実際には各シリーズの返却JSONフィールドに基づいて判定してください。ページ送り時は対応するカーソルフィールドをそのまま返却先に渡してください（2シリーズでフィールドが異なります。詳細は下記参照）。

6.2.1 [App V2] 話題ノート一覧を取得 ⭐ 推奨

方法：GET
パス：/api/v1/xiaohongshu/app_v2/get_topic_feed
公式ドキュメント：docs.tikhub.io/420136408e0
パラメータ：
- page_id (string, 必須)：話題ページID
- sort (string, 任意)：trend（人気順、デフォルト）/ time（最新）
- cursor_score (string, 任意)：ページングカーソルのスコア。ページ送り時は前ページ最後の item の cursor_score を渡す
- last_note_id (string, 任意)：ページ送り時は前ページ最後のノートID（items[-1].id）を渡す
- last_note_ct (string, 任意)：ページ送り時は前ページ最後のノート作成時刻（items[-1].create_time）を渡す
- session_id (string, 任意)：セッションID。ページ送り時も同一を維持
- first_load_time (string, 任意)：初回読み込み時刻のタイムスタンプ。ページ送り時も同一を維持
- source (string, 任意)：ソース、デフォルト normal

python
url = f"{BASE_URL}/api/v1/xiaohongshu/app_v2/get_topic_feed"

# First request: pass only page_id and sort / 首次请求：只传 page_id 和 sort
params = {
    "page_id": "5c1cc866febed9000184b7c1",
    "sort": "trend",
}
r = requests.get(url, headers=HEADERS, params=params)
data = r.json()
print(data)

# Next page: pass through the following fields from the first response / 翻页请求：从首次响应中取下列字段透传
# items = data["data"]["items"]
# next_params = {
#     "page_id": "5c1cc866febed9000184b7c1",
#     "sort": "trend",
#     "cursor_score": items[-1]["cursor_score"],
#     "last_note_id": items[-1]["id"],
#     "last_note_ct": items[-1]["create_time"],
#     "session_id": data["data"]["session_id"],
#     "first_load_time": data["data"]["first_load_time"],
# }

6.2.2 [App V1] 話題タグに基づいて作品を取得（廃止済みの `get_notes_by_topic` の代替）

⚠️ App V1 の旧API /api/v1/xiaohongshu/app/get_notes_by_topic は廃止済みです。本APIを直接使用してください。

方法：GET
パス：/api/v1/xiaohongshu/app/get_topic_notes
公式ドキュメント：docs.tikhub.io/454758056e0
パラメータ：
- page_id (string, 必須)：話題タグID
- first_load_time (string, 必須)：初回リクエスト時刻（ミリ秒）、Pythonでの取得：int(time.time() * 1000)
- sort (string, 任意)：hot（総合、デフォルト）/ time（最新）/ trend（人気順）
- last_note_ct (string, 任意)：ページ送り時は前ページ最後のノートの create_time を渡す
- last_note_id (string, 任意)：ページ送り時は前ページ最後のノートIDを渡す
- cursor_score (string, 任意)：ページ送り時は前ページ最後のノートの cursor_score を渡す
- session_id (string, 任意)：セッションID。初回はサーバー側で生成され、ページ送り時に返却する

python
import time

url = f"{BASE_URL}/api/v1/xiaohongshu/app/get_topic_notes"

# First request / 首次请求
params = {
    "page_id": "5c1cc866febed9000184b7c1",
    "first_load_time": str(int(time.time() * 1000)),
    "sort": "hot",
}
r = requests.get(url, headers=HEADERS, params=params)
data = r.json()
print(data)

# Next page: keep page_id / first_load_time unchanged, pass session_id and last_* through / 翻页请求：保持 page_id / first_load_time 不变，把 session_id 和 last_* 透传
# notes = data["data"]["notes"]
# next_params = {
#     "page_id": "5c1cc866febed9000184b7c1",
#     "first_load_time": params["first_load_time"],
#     "sort": "hot",
#     "session_id": data["data"]["session_id"],
#     "last_note_id": notes[-1]["id"],
#     "last_note_ct": notes[-1]["note"]["create_time"],
#     "cursor_score": notes[-1].get("cursor_score", ""),
# }

XHS（小红書）使用ガイド

目次

共通説明

1. 単一ノート

総合例：3シリーズを組み合わせて単一ノート詳細を取得

1.1 画像ノート（図文ノート）

1.1.1 [App V2] 図文ノート詳細を取得 ⭐ 推奨

1.1.2 [App V1] ノート情報を取得 V1（図文のみ、動画ダウンロードリンクなし）

1.1.3 [Web V3] ノート詳細を取得（図文/動画共通）

1.2 動画ノート

1.2.1 [App V2] 動画ノート詳細を取得 ⭐ 推奨

1.2.2 [Web V3] ノート詳細を取得（動画共通）

2. ユーザー情報

総合例：3シリーズを組み合わせてユーザー情報を取得

2.1 [App V2] ユーザー情報を取得 ⭐ 推奨

2.2 [App V1] ユーザー情報を取得

2.3 [App V1] 補助ツール：ユーザー共有リンクから user_id と xsec_token を抽出

2.4 [Web V3] ユーザー情報を取得

3. ユーザー作品

総合例：3シリーズを組み合わせてユーザーの公開ノートを取得

3.1 [App V2] ユーザーの公開ノート一覧を取得 ⭐ 推奨

3.2 [App V2] ユーザーの公開お気に入りノート一覧を取得（App V2 のみ）

3.3 [App V1] ユーザー作品一覧を取得

3.4 [Web V3] ユーザーノート一覧を取得

4. コメント

4.1 一次コメント（ノート下のコメント一覧）

総合例：3シリーズを組み合わせて一次コメントを取得

4.1.1 [App V2] ノートコメント一覧を取得 ⭐ 推奨

4.1.2 [App V1] ノートコメントを取得

4.1.3 [Web V3] ノートコメントを取得

4.2 二次コメント（子コメント / 返信一覧）

総合例：3シリーズを組み合わせて子コメントを取得

4.2.1 [App V2] ノート二次コメント一覧を取得 ⭐ 推奨

4.2.2 [App V1] 子コメントを取得

4.2.3 [Web V3] 子コメントを取得

5. 検索

5.1 ノート検索

総合例：3シリーズを組み合わせてノートを検索

5.1.1 [App V2] ノート検索 ⭐ 推奨

5.1.2 [App V1] ノート検索

5.1.3 [Web V3] ノート検索

5.2 ユーザー検索

総合例：2シリーズを組み合わせてユーザーを検索

5.2.1 [App V2] ユーザー検索 ⭐ 推奨

5.2.2 [Web V3] ユーザー検索

6. 話題

6.1 話題詳細

6.1.1 [App V2] 話題詳細を取得 ⭐ App V2 のみ

6.2 話題ノート一覧（話題下のノート）

総合例：2シリーズを組み合わせて話題ノートを取得

6.2.1 [App V2] 話題ノート一覧を取得 ⭐ 推奨

6.2.2 [App V1] 話題タグに基づいて作品を取得（廃止済みの get_notes_by_topic の代替）

6.2.2 [App V1] 話題タグに基づいて作品を取得（廃止済みの `get_notes_by_topic` の代替）