# 快速开始

> 创建 API 密钥，发起一次网页搜索请求，并理解响应内容。

Canonical URL: https://s1.dev/zh/docs/get-started/quickstart

<Steps>

<Step>

### 获取 API 密钥

在 [app.s1.dev](https://app.s1.dev) 注册，然后打开 **API Keys** 页面创建密钥。新账户可获得 [100 个免费 Search API 积分](https://s1.dev/free-search-api?utm_source=docs&utm_medium=referral&utm_campaign=free_search_api)，无需信用卡，且不会过期。

请把密钥保存在服务端。本地开发时，可以将其放入环境变量：

```bash
export SEARCH1API_KEY="YOUR_API_KEY"
```

</Step>

<Step>

### 搜索网页

```bash
curl -X POST https://api.search1api.com/search \
  -H "Authorization: Bearer $SEARCH1API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "best open source vector databases"}'
```

</Step>

<Step>

### 读取响应

```json
{
  "searchParameters": {
    "query": "best open source vector databases",
    "max_results": 5
  },
  "results": [
    {
      "title": "Qdrant - Vector Database",
      "link": "https://qdrant.tech/",
      "snippet": "Qdrant is an open source vector database...",
      "published_date": "2026-09-03",
      "content": ""
    }
  ]
}
```

搜索默认最多返回五条结果。`snippet` 是搜索引擎给出的摘要。`published_date` 是页面的发布日期，采用 ISO 8601 格式；如果来源没有提供发布日期，则省略该字段。当你让 Search1API 抓取某条结果时，`content` 才会被填充。

</Step>

<Step>

### 决定下一步要构建什么

你的第一个请求已经完成。接下来：

- 如果模型需要完整的页面文本，请在[优化搜索结果](https://s1.dev/zh/docs/guides/improving-search-results#read-the-results-not-just-the-snippets)中了解如何使用 `crawl_results`。
- 如果你从 URL 开始，或需要结构化数据，请参阅[选择端点](https://s1.dev/zh/docs/guides/choosing-an-endpoint)。
- 上线生产环境前，请阅读[认证](https://s1.dev/zh/docs/essentials/authentication)、[积分与限制](https://s1.dev/zh/docs/essentials/credits-and-limits)和[错误处理](https://s1.dev/zh/docs/essentials/error-handling)。

</Step>

</Steps>

## 其他接入方式

- [官方 SDK](https://s1.dev/zh/docs/integrations/sdks): 使用带类型的 TypeScript 或 Python 客户端，内置重试、错误处理和 deepcrawl 轮询。

- [Search API 参考](https://s1.dev/zh/docs/basic/search): 查看所有请求字段和响应 Schema。

- [MCP 服务器](https://s1.dev/zh/docs/integrations/mcp): 无需编写 API 代码，即可连接兼容 MCP 的 AI 客户端。

- [CLI](https://s1.dev/zh/docs/integrations/cli): 在终端中搜索和抓取。