跳转到主要内容
POST
/
search
搜索并按需抓取搜索结果
curl --request POST \
  --url https://api.firecrawl.dev/v1/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "limit": 5,
  "tbs": "<string>",
  "location": "<string>",
  "timeout": 60000,
  "ignoreInvalidURLs": false,
  "scrapeOptions": {}
}
'
{
  "success": true,
  "data": [
    {
      "title": "<string>",
      "description": "<string>",
      "url": "<string>",
      "markdown": "<string>",
      "html": "<string>",
      "rawHtml": "<string>",
      "links": [
        "<string>"
      ],
      "screenshot": "<string>",
      "metadata": {
        "title": "<string>",
        "description": "<string>",
        "sourceURL": "<string>",
        "statusCode": 123,
        "error": "<string>"
      }
    }
  ],
  "warning": "<string>"
}
注意:现已推出该 API 的全新 v2 版本,功能与性能均有升级。
该 /search 端点将网页搜索与 Firecrawl 的抓取能力相结合,可为任意查询返回完整页面内容。 在请求中包含 scrapeOptions 并设置 formats: ["markdown"],即可为每个搜索结果获取完整的 markdown 内容;否则将默认仅返回结果(url、title、description)。

支持的查询运算符

我们提供多种查询运算符,帮助你更精准地筛选搜索结果。
运算符功能示例
""对一段文本进行精确匹配"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

Location 参数

使用 location 参数获取按地理位置定向的搜索结果。格式:“string”。示例:“Germany”、“San Francisco,California,United States”。 请参阅完整的支持位置列表,了解所有可用的国家和语言。 使用 tbs 参数按时间范围筛选结果,支持自定义日期区间。详见搜索功能文档,其中包含详细示例和支持的 formats。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
query
string
必填

搜索查询

limit
integer
默认值:5

返回的最大结果数

必填范围: 1 <= x <= 100
tbs
string

基于时间的搜索参数。支持预定义时间范围(qdr:hqdr:dqdr:wqdr:mqdr:y)以及自定义日期范围(cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY)。

location
string

搜索结果的 location 参数

timeout
integer
默认值:60000

超时时间(毫秒)

ignoreInvalidURLs
boolean
默认值:false

会从搜索结果中排除对其他 Firecrawl 端点无效的 URL。这样当你将搜索结果数据传递到其他 Firecrawl API 端点时,可以减少出错。

scrapeOptions
object

搜索结果抓取选项

响应

成功响应

success
boolean
data
object[]
warning
string | null

出现问题时显示的警告信息