Developers
一次请求，得到结构化网页结果
公共搜索端点可以直接试用，无需先注册或申请密钥。结果不足时会标明外部来源；只有本站已索引结果才支持按 ID 获取全文。
1. 发送第一次请求
q 是唯一必填参数。公共层无需 Authorization 请求头，适合验证接入和低频使用。
curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"2. 正确处理来源与正文
source=local 表示来自图图搜本地索引，source=brave 表示本地结果不足时的全网兜底。
- 始终使用 url 作为跳转地址，不推导或拼接外部地址。
- 仅 local 且带非空 id 的结果可调用 /api/v1/content/{id}。
- 客户端应处理 429、超时、网络断开和空结果，不把重试做成无限循环。
3. 分页与资源边界
网页端每页 10 条并限制深分页。API 端会限制查询长度、每页条数和可接受的分页深度，避免单个请求挤占全部搜索资源。
- 查询词最长 512 个字符。
- limit 最大 100；普通界面建议 10–20。
- time_range 按图图搜抓取/收录时间过滤，不等同于原文发布时间。
- 遇到 429/503 应指数退避并限制重试次数，避免重试风暴。