快速开始

2分钟内获取您的第一个搜索结果。

1. 获取API密钥

在 Scavio控制台注册，并在 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. 与LangChain一起使用

安装 langchain-scavio 在您的智能体中使用Scavio作为LangChain工具。支持Google、Amazon、Walmart和YouTube。

pip install langchain-scavio

后续步骤

Google Search API -- 完整端点参考及响应格式
YouTube API -- 搜索和元数据
Amazon API -- 产品搜索和详情
Walmart 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"
  }'