你想整理自己做过的家居改造记录,账号里既有图文过程,也有视频演示。只把所有链接堆在文件夹里,回头很难找到某一步的材料。先建立清楚的笔记目录,再决定后续需要保存什么。

账号列表留下来源与覆盖范围

用已发布笔记接口查询目标账号,按文档准备 user_id 或分享信息,核对身份后再翻页。保留 cursor 与实际读取范围,按笔记标识去重。置顶内容、重复出现的笔记和新发布作品分开记录,避免把列表位置当成时间顺序。

图文详情与视频详情不能混用

按内容类型选择对应接口。图文接口对视频笔记只提供封面等基础数据,不含播放链接,因此拿到封面不能说明视频媒体信息齐全。note_id 与分享链接同时传入时注意文档优先规则,不要让旧 ID 指向错误作品。未知类型先人工核实。

为每篇笔记写明资料状态

目录可列来源、改造阶段、内容类型、取得的媒体信息、查询时间和后续动作。图片里的文字或视频里的操作需要另行阅读观看,API 不会自动变成完整施工记录。媒体地址只按实际响应登记,不虚构统一字段或假定长期有效;没有取得的项写待处理。

保存文件后再标归档完成

这组详情查询并不是自动下载、去水印或剪辑服务。后续若实际保存,需要核对文件与笔记项目对应关系,确认结果能使用再改状态。AI 可整理目录描述,但不能补造下载文件名或声称已经检查画质。最终先交付准确的材料索引,明确还缺哪些步骤;它既方便回顾自己的改造过程,也能避免以后把某次查询结果误认为一套已经完整落地的本地素材。

这篇用到的接口

完整地址与参数

GET https://api.trmesh.com/openapi/api/v1/xiaohongshu/app_v2/get_user_posted_notes

参数 类型 必填 含义
user_id string 否 用户ID
share_text string 否 分享链接,支持xiaohongshu.com
cursor string 否 分页游标,首次请求留空

可以复制的 Python 请求

安装 requests 并在环境变量中设置 TRMESH_API_TOKEN。把示例用户名或作品 ID 换成你要查询的对象。

import os
import requests

# 使用自己的 TRMesh 开发者密钥;不要将密钥写入网页。
url = "https://api.trmesh.com/openapi/api/v1/xiaohongshu/app_v2/get_user_posted_notes"
params = {
    "user_id": "61b46d790000000010008153",
    "share_text": "http://xhslink.com/o/8GqargIxrko"
}
response = requests.get(
    url, params=params, timeout=30,
    headers={"Authorization": f"Bearer {os.environ['TRMESH_API_TOKEN']}"},
)
response.raise_for_status()
payload = response.json()
print(payload)  # 先核对真实响应,再提取业务字段

对应接口文档 · 返回免费查询工具

调用接口会使用你的 TRMesh 账号额度,运行前请确认接口价格。