メインコンテンツへスキップ
Endpoint: GET /customsearch/v1 cx を指定して Google Custom Search を実行します。省略時は YouRouter の既定検索エンジンを使います。 Web の最新情報、社内ドキュメント探索、独自サイト向けの Programmable Search などに使えます。
検索も ゼロ完了保険 の対象です。失敗や空結果は成功 completion として課金されません。
import requests
import json

response = requests.get(
    "https://api.yourouter.ai/customsearch/v1",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={
        "q": "how to set up billing",
        "cx": "YOUR_CUSTOM_SEARCH_ENGINE_ID",
        "num": 3,
    },
)
print(json.dumps(response.json(), indent=2))

​
パラメータ

パラメータ型説明必須
qstring検索クエリはい
cxstringCSE ID。省略時は既定いいえ
numinteger返す件数（1〜10）いいえ
startinteger先頭インデックスいいえ
siteSearchstringサイト限定いいえ

レスポンス形式

成功時は items 配列に検索結果が入ります。
{
  "kind": "customsearch#search",
  "items": [
    {
      "kind": "customsearch#result",
      "title": "Billing Information - Example Docs",
      "link": "https://docs.example-app.ai/billing"
    }
  ]
}

​
代表的なユースケース

ドキュメントドメインだけを索引する CSE を作り、検索上位をモデルに渡して根拠付き回答を作れます。
最新記事やページを取得してから要約・推論に回します。