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 應指數退避並限制重試次數，避免重試風暴。