用任务名称代替宽泛兴趣

如果你只想学会给家庭相册剪一段短片，搜索“剪辑”会带来过多无关课程。把具体软件或要完成的动作写进 keyword，先找能够帮助完成眼前任务的内容。综合搜索返回的是检索信息，不会自动判断你的基础，也不能承诺第一个结果就是最适合新手的教程。

时长筛选服务于自己的安排

根据阅读计划选择 duration、order 和 page_size，使用 page 查看后续结果；需要限定内容时间时核对 pubtime_begin_s 与 pubtime_end_s 的参数说明。不要把筛选条件当作搜索结果天然具备的事实。新版软件可能改变操作界面，教程发布时间只是一个检查线索，仍要对照实际步骤是否适用于你当前使用的版本。

用一次小练习决定是否继续

假设你找到两条素材剪切教程，可以先分别观看与目标动作有关的部分，用自己的素材做一次练习，记录来源、能否复现以及卡住的位置。这个结果比观看人数或搜索位置更能帮助选择下一条学习材料。不要在搜索清单里虚构评分，也不将所有候选称为经过验证的推荐。最终留下一个可以完成的练习路径，让搜索结束于实际产出而不是不断增加待看列表。

完整地址与参数

GET https://api.trmesh.com/openapi/api/v1/bilibili/web/fetch_general_search

参数 类型 必填 含义
keyword string 是 搜索关键词
order string 是 排序方式
page integer 是 页码
page_size integer 是 每页数量
duration integer 否 时长筛选
pubtime_begin_s integer 否 开始日期
pubtime_end_s integer 否 结束日期

可以复制的 Python 请求

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

import os
import requests

# 使用自己的 TRMesh 开发者密钥；不要将密钥写入网页。
url = "https://api.trmesh.com/openapi/api/v1/bilibili/web/fetch_general_search"
params = {
    "keyword": "火影忍者",
    "order": "totalrank",
    "page": "1",
    "page_size": "42"
}
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 账号额度，运行前请确认接口价格。