Developers

1 回のリクエストで構造化ウェブ結果

公開検索エンドポイントは登録も API key も不要。ローカル結果が乏しいときは明示ラベル付きの外部ソースで補完;全文はローカル索引済み結果のみ。

API ドキュメントを読む ウェブ検索を試す

1. 最初のリクエストを送る

q が唯一の必須パラメータ。公共層は Authorization ヘッダー不要で、評価や少量利用に適します。

curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"

2. ソースとコンテンツを正しく扱う

source=local は TutuSoo インデックス由来;source=brave はローカル網羅が薄いときのウェブ・フォールバック。

  • 返却された url で遷移すること。id から外部アドレスを導出しないでください。
  • 空でない id を持つローカル結果に対してのみ /api/v1/content/{id} を呼び出す。
  • 429・タイムアウト・オフライン・空結果を、無限リトライせず適切に処理する。

3. ページングとリソース上限

Web UI は 1 ページ 10 件で深いページングを制限。API はクエリ長・結果数・許容深度を制限し、単一リクエストが検索資源を独占しないようにします。

  • クエリは 512 文字までです。
  • limit は最大 100、推奨は 10〜20。
  • time_range は TutuSoo のクロール/索引時刻でフィルタし、ページの公開日ではありません。
  • 429 や 503 には上限付き指数バックオフを使い、リトライ嵐を回避する。