# 简介

> Search1API 为 AI 应用提供一个 API，用于从实时网络中发现、读取和结构化信息。

Canonical URL: https://s1.dev/zh/docs

Search1API 通过一个 API 为 AI 应用提供实时网络访问能力。它把网页搜索与新闻搜索、网页抓取、网页截图、站点发现、热门榜单和基于 Schema 的结构化提取整合在同一个 Base URL 和 API 密钥之下。

当智能体、RAG 流水线或后端服务需要获取最新信息，又不想自己维护搜索引擎适配器或爬虫基础设施时，就可以使用它。

## 一个简单的思维模型

- [发现](https://s1.dev/zh/docs/basic/search): 通过网页搜索找到相关页面；用智能搜索（Ask）以自然语言描述需求；通过新闻搜索获取近期报道；或通过热门榜单跟进当下的开发者话题。

- [读取](https://s1.dev/zh/docs/basic/crawl): 把单个页面转换为干净的文本，通过 crawl_results 获取排名靠前的搜索结果内容，或异步抓取整个站点。

- [截取](https://s1.dev/zh/docs/basic/screenshot): 将整个页面、视口或页面元素渲染为 PNG、JPEG 或 WebP 图片。

- [结构化](https://s1.dev/zh/docs/advanced/extract): 按照你定义的 JSON 结构，从页面中提取字段。

大多数智能体工作流都从 `/search` 开始。当模型需要的是来源原文而不只是链接和摘要时，加上 `crawl_results`。如果你已经有 URL，则直接从 `/crawl` 开始。如果你清楚自己要找什么，但不确定该用哪个引擎，可以使用 [`/ask`](https://s1.dev/zh/docs/basic/ask)，让 Search1API 来选择引擎和时间范围。

完整的选择指南请参阅[选择端点](https://s1.dev/zh/docs/guides/choosing-an-endpoint)。

## 选择你的起点

- [发起第一次 API 调用](https://s1.dev/zh/docs/get-started/quickstart): 创建密钥，发送一个请求，并理解响应内容。

- [接入官方 SDK](https://s1.dev/zh/docs/integrations/sdks): 在应用代码中安装 TypeScript 或 Python 客户端。

- [连接 AI 工具](https://s1.dev/zh/docs/integrations/mcp): 通过 MCP、CLI 或智能体技能使用 Search1API。

- [选择端点](https://s1.dev/zh/docs/guides/choosing-an-endpoint): 根据任务匹配 search、crawl、screenshot、extract、sitemap 和 deepcrawl。

## 准备上线生产环境时

- [认证](https://s1.dev/zh/docs/essentials/authentication): 安全地存储、区分和吊销 API 密钥。

- [积分与限制](https://s1.dev/zh/docs/essentials/credits-and-limits): 了解请求费用、余额和速率限制。

- [错误处理](https://s1.dev/zh/docs/essentials/error-handling): 处理校验、认证、支付和上游服务错误。

- [更新日志](https://s1.dev/zh/docs/changelog): 兼容性承诺，以及 API、SDK、CLI 和 MCP 服务器按日期记录的变更。