クイックスタート

2分以内で最初の検索結果を取得します。

1. APIキーを取得する

Scavio Dashboardにサインアップし、API KeysページからAPIキーを作成します。キーはsk_live_またはsk_test_で始まります。

2. 最初のリクエストを送信する

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"query": "Scavio search API"}'

3. レスポンスを読む

成功したレスポンスは、results配列を含むJSONオブジェクトを返します。各結果にはtitle、url、contentが含まれます。

JSON

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform...",
      "position": 1
    }
  ],
  "query": "Scavio search API",
  "response_time": 450,
  "credits_used": 1,
  "credits_remaining": 999
}

4. 高度なパラメータを試す

オプションパラメータを追加して検索をカスタマイズします。この例では米国のニュースを検索します：

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "AI startups funding",
    "search_type": "news",
    "country_code": "us",
    "language": "en"
  }'

5. Python SDKを使用する

公式のPython SDKは、同期および非同期サポート、組み込みのレート制限、および全6つのデータソースへのアクセスを備えた型付きクライアントを提供します。

pip install scavio

6. LangChainで使用する

langchain-scavioをインストールして、エージェント内でScavioをLangChainツールとして使用します。Google、Amazon、Walmart、YouTubeをサポートします。

pip install langchain-scavio

次のステップ

Google Search API -- 完全なエンドポイントリファレンスとレスポンス形式
YouTube API -- 検索とメタデータ
Amazon API -- 商品検索と詳細
Walmart API -- 商品検索と詳細
Country Codes -- サポートされている国コードのリファレンス

3. レスポンスを読む

成功したレスポンスは、results配列を含むJSONオブジェクトを返します。各結果にはtitle、url、contentが含まれます。

JSON

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform...",
      "position": 1
    }
  ],
  "query": "Scavio search API",
  "response_time": 450,
  "credits_used": 1,
  "credits_remaining": 999
}

4. 高度なパラメータを試す

オプションパラメータを追加して検索をカスタマイズします。この例では米国のニュースを検索します：

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "AI startups funding",
    "search_type": "news",
    "country_code": "us",
    "language": "en"
  }'