XHS（小红书）使用指南

基于 TikHub OpenAPI（https://api.tikhub.io）整理的小红书接口文档。

通用说明

a. 调用策略：多系列搭配使用（重要）

小红书接口目前最稳定的是 App V2 系列。强烈建议所有用户采用"主系列 + 1~2 个备用系列"的搭配策略，将 2~3 个系列组合使用，提升整体业务可用性。

b. 调用优先级：App V2（推荐）> App V1（兜底）> Web V3（第三备选）

App V2 为主推荐系列，当前最稳定、数据最完整，建议作为首选；App V1 与 App V2 字段口径接近，适合作为第一备用兜底；Web V3 是面向企业用户开放的第三备选 Web 端通道，需要 xsec_token（可由分享链接抽取），但返回的数据维度比 App V2 / App V1 少，因此即便是企业用户也建议合理搭配多个系列一起使用，不要只用 Web V3；Web V2 / Web 系列只有小部分接口可用、稳定性也不一定有保障，不推荐作为主力，仅在前面三个系列都不满足需求时作为补充。

c. 一句话建议：不要只押注一个系列。生产环境推荐至少配置 2 个系列做主备搭配；企业用户使用 Web V3 时，请额外搭配 App V2 / App V1 来补足数据维度。

d. 返回字段提示：App 系列接口（App V2 / App V1）之间结构相似，字段命名基本可以互相对应；但 Web 系列接口（Web V3 / Web V2 / Web）返回的 JSON 结构各不相同，字段名、嵌套层级、数据维度都可能不一样，使用时请务必先查看每个接口的实际返回 JSON 字段，再做解析和映射。

1. 单一笔记

小红书的笔记分为两类：图文笔记（图片笔记） 和 视频笔记。App V2 系列为两种类型提供了独立的端点，数据最完整；Web V3 用同一个接口处理两种类型，由响应字段区分。

通用建议：优先使用 App V2 系列；企业用户在能拿到 xsec_token 的场景下可搭配 Web V3 使用。

综合示例：三系列搭配获取单一笔记详情

下面给出一段示意代码，演示**主系列（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] 获取图文笔记详情 ⭐ 推荐

获取图文笔记的完整详情数据（图片地址、标题、正文、标签、互动数据等）。

方法：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 的笔记接口，仅适用于图文笔记。返回中不包含视频下载链接，因此不要用它取视频笔记；视频笔记请改用 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（从分享链接抽取，见上方"配套工具接口"）。

方法：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，该接口返回内容里不含视频下载链接。请使用下面的 App V2 或 Web V3。

1.2.1 [App V2] 获取视频笔记详情 ⭐ 推荐

获取视频笔记的完整详情数据（视频地址、封面、时长、标题、正文、互动数据等）。

方法：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 调用即可。

方法：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 获取小红书用户的公开资料（昵称、头像、简介、粉丝数、关注数、笔记数等）。三个系列都提供了用户信息接口；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 这个工具接口（官方文档），把任意一条小红书用户主页分享链接（长链/短链都行）传进去，就能解析出 user_id 和 xsec_token，再喂给下面的用户信息接口即可。详见下方 2.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 的用户信息接口。

方法：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

如果手上只有一条用户主页分享链接（长链/短链都支持），可以先用这个接口解析出 user_id 和 xsec_token，再去调用上面的用户信息接口。

方法：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 的用户公开资料接口，只需要 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 拉取该用户发布的笔记列表（图文/视频混合），所有接口都使用游标分页（cursor）。App V2 系列额外提供了"用户公开收藏笔记列表"接口（faved notes），App V1 / Web V3 只覆盖"已发布笔记"。

通用建议：优先使用 App V2 系列；只有 user_id 时也可走 App V1 / Web V3。

💡 不知道怎么拿 user_id？参考上面 2.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 收藏的内容），使用游标分页。该接口仅 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 的用户作品接口，只覆盖已发布笔记，使用游标分页。

方法：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 的用户作品接口，使用游标分页，可以指定单页数量（最大 30）。

方法：GET
路径：/api/v1/xiaohongshu/web_v3/fetch_user_notes
官方文档：docs.tikhub.io/438852178e0
参数：
- user_id (string, 必填)
- cursor (string, 可选)：分页游标
- num (integer, 可选)：单页数量，默认 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. 评论

小红书的评论分为两层：一级评论（笔记下的评论列表） 和 二级评论（某条评论下的回复/子评论列表）。三个系列都提供了这两层接口；App V2 字段最丰富，App V1 / Web V3 适合作备用。

通用建议：优先使用 App V2 系列；Web V3 接口需要 xsec_token（可由分享链接抽取，见 1. 单一笔记 综合示例 / 2.3 工具接口）。

4.1 一级评论（笔记下的评论列表）

综合示例：三系列搭配获取一级评论

下面给出一段示意代码，演示**主系列（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, 可选)：翻页游标，首次留空；支持两种格式 —— 简单格式（如 "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 二级评论（子评论 / 回复列表）

获取某条一级评论下的所有回复（子评论），同样三系列覆盖。注意 Web V3 这里参数叫 root_comment_id，其他两个系列叫 comment_id。

综合示例：三系列搭配获取子评论

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. 搜索

小红书搜索分两类：搜索笔记 和 搜索用户。

搜索笔记：App V2 / App V1 / Web V3 三个系列都提供，App V2 字段最丰富（支持排序、笔记类型、时间筛选、AI 模式等）。
搜索用户：只有 App V2 和 Web V3 提供，App V1 没有用户搜索接口。

通用建议：优先使用 App V2 系列；翻页时记得带上首次搜索返回的 search_id / session_id（不同系列参数名略有差异）。

5.1 搜索笔记

综合示例：三系列搭配搜索笔记

下面给出一段示意代码，演示**主系列（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 没有用户搜索接口，本节只有 App V2 和 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_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] 搜索用户 ⭐ 推荐

每页固定返回 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. 话题

小红书话题相关接口分两部分：话题详情 和 话题下的笔记列表。

⚠️ 重要说明：

Web V3 系列没有话题接口，本节只有 App V2 和 App V1 两个系列。

App V1 的旧接口 /api/v1/xiaohongshu/app/get_notes_by_topic 已弃用，请改用本节的 get_topic_notes。

所有接口都以 page_id（话题/话题标签 ID）作为唯一标识。

6.1 话题详情

仅 App V2 提供话题详情接口（话题名称、浏览量、讨论数、分享信息等）。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 都提供，但参数和翻页字段差异较大，需要分别适配。

综合示例：双系列搭配获取话题笔记

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 字段做判断；翻页时记得把对应游标字段透传回去（两个系列字段不同，详见下方）。

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/v1/xiaohongshu/app/get_notes_by_topic 已弃用，请直接使用本接口。

方法：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. 单一笔记

综合示例：三系列搭配获取单一笔记详情

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. 用户信息

综合示例：三系列搭配获取用户信息

2.1 [App V2] 获取用户信息 ⭐ 推荐

2.2 [App V1] 获取用户信息

2.3 [App V1] 配套工具：从用户分享链接提取 user_id 和 xsec_token

2.4 [Web V3] 获取用户信息

3. 用户作品

综合示例：三系列搭配获取用户已发布笔记

3.1 [App V2] 获取用户已发布笔记列表 ⭐ 推荐

3.2 [App V2] 获取用户公开收藏的笔记列表（仅 App V2）

3.3 [App V1] 获取用户作品列表

3.4 [Web V3] 获取用户笔记列表

4. 评论

4.1 一级评论（笔记下的评论列表）

综合示例：三系列搭配获取一级评论

4.1.1 [App V2] 获取笔记评论列表 ⭐ 推荐

4.1.2 [App V1] 获取笔记评论

4.1.3 [Web V3] 获取笔记评论

4.2 二级评论（子评论 / 回复列表）

综合示例：三系列搭配获取子评论

4.2.1 [App V2] 获取笔记二级评论列表 ⭐ 推荐

4.2.2 [App V1] 获取子评论

4.2.3 [Web V3] 获取子评论

5. 搜索

5.1 搜索笔记

综合示例：三系列搭配搜索笔记

5.1.1 [App V2] 搜索笔记 ⭐ 推荐

5.1.2 [App V1] 搜索笔记

5.1.3 [Web V3] 搜索笔记

5.2 搜索用户

综合示例：两系列搭配搜索用户

5.2.1 [App V2] 搜索用户 ⭐ 推荐

5.2.2 [Web V3] 搜索用户

6. 话题

6.1 话题详情

6.1.1 [App V2] 获取话题详情 ⭐ 仅 App V2

6.2 话题笔记列表（话题下的笔记）

综合示例：双系列搭配获取话题笔记

6.2.1 [App V2] 获取话题笔记列表 ⭐ 推荐

6.2.2 [App V1] 根据话题标签获取作品（替代已弃用的 get_notes_by_topic）

6.2.2 [App V1] 根据话题标签获取作品（替代已弃用的 `get_notes_by_topic`）