# Search

> 注意：现已推出该 API 的全新 [v2 版本](/zh/api-reference/endpoint/search)，功能与性能均有升级。

该 /search 端点将网页搜索与 Firecrawl 的抓取能力相结合，可为任意查询返回完整页面内容。

在请求中包含 `scrapeOptions` 并设置 `formats: ["markdown"]`，即可为每个搜索结果获取完整的 markdown 内容；否则将默认仅返回结果 (url、title、description) 。

<div id="supported-query-operators">
  ## 支持的查询运算符
</div>

我们提供多种查询运算符，帮助你更精准地筛选搜索结果。

| 运算符 | 功能 | 示例 |
---|-|-|
| `""` | 对一段文本进行精确匹配 | `"Firecrawl"`
| `-` | 排除特定关键词或对其他运算符取反 | `-bad`, `-site:firecrawl.dev`
| `site:` | 仅返回来自指定网站的结果 | `site:firecrawl.dev`
| `inurl:` | 仅返回在 URL 中包含某个词的结果 | `inurl:firecrawl`
| `allinurl:` | 仅返回在 URL 中包含多个词的结果 | `allinurl:git firecrawl`
| `intitle:` | 仅返回在页面标题中包含某个词的结果 | `intitle:Firecrawl`
| `allintitle:` | 仅返回在页面标题中包含多个词的结果 | `allintitle:firecrawl playground`
| `related:` | 仅返回与特定域名相关的结果 | `related:firecrawl.dev`

<div id="location-parameter">
  ## Location 参数
</div>

使用 `location` 参数获取按地理位置定向的搜索结果。格式：&quot;string&quot;。示例：&quot;Germany&quot;、&quot;San Francisco,California,United States&quot;。

请参阅[完整的支持位置列表](https://firecrawl.dev/search_locations.json)，了解所有可用的国家和语言。

<div id="time-based-search">
  ## 基于时间的搜索
</div>

使用 `tbs` 参数按时间范围筛选结果，支持自定义日期区间。详见[搜索功能文档](https://docs.firecrawl.dev/features/search#time-based-search)，其中包含详细示例和支持的 formats。