Custom Search

Endpoint: GET /customsearch/v1 cx を指定して Google Custom Search を実行します。省略時は YouRouter の既定検索エンジンを使います。 Web の最新情報、社内ドキュメント探索、独自サイト向けの Programmable Search などに使えます。

検索もゼロ完了保険の対象です。失敗や空結果は成功 completion として課金されません。

import os
import requests
import json

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

curl "https://api.yourouter.ai/customsearch/v1?q=billing&cx=YOUR_CX_ID" \
  -H "Authorization: Bearer $YOUROUTER_API_KEY"

パラメータ

パラメータ	型	説明	必須
`q`	string	検索クエリ	はい
`cx`	string	CSE ID。省略時は既定	いいえ
`num`	integer	返す件数（1〜10）	いいえ
`start`	integer	先頭インデックス	いいえ
`siteSearch`	string	サイト限定	いいえ

レスポンス形式

成功時は items 配列に検索結果が入ります。

{
  "kind": "customsearch#search",
  "items": [
    {
      "kind": "customsearch#result",
      "title": "Billing Information - Example Docs",
      "link": "https://docs.example-app.ai/billing"
    }
  ]
}

代表的なユースケース

自社ドキュメントの Q&A

ドキュメントドメインだけを索引する CSE を作り、検索上位をモデルに渡して根拠付き回答を作れます。

リアルタイム Web 取得

最新記事やページを取得してから要約・推論に回します。

Gemini Generate Content リクエスト転送

はじめに

モデル API

ルーティングと信頼性

API リファレンス

機能

法務

パラメータ

レスポンス形式

代表的なユースケース

​パラメータ

レスポンス形式

​代表的なユースケース

パラメータ

代表的なユースケース