Skip to main content
POST
搜索并按需抓取搜索结果
注意:现已推出该 API 的全新 v2 版本,功能与性能均有升级。
该 /search 端点将网页搜索与 Firecrawl 的抓取能力相结合,可为任意查询返回完整页面内容。 在请求中包含 scrapeOptions 并设置 formats: ["markdown"],即可为每个搜索结果获取完整的 markdown 内容;否则将默认仅返回结果 (url、title、description) 。

支持的查询运算符

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

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
必填

搜索查询

ignoreInvalidURLs
boolean
默认值:false

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

limit
integer
默认值:5

返回的最大结果数

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

搜索结果的 location 参数

scrapeOptions
object

搜索结果抓取选项

tbs
string

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

threatProtection
Threat Protection Override · object

此请求的 威胁防护 单次请求覆盖配置。你提供的字段只会替换本次请求中组织策略里的对应字段;未提供的字段将保留组织级别的值。你的团队必须已启用威胁防护(企业版功能),否则该请求将被 403 拒绝。如果你的组织已禁用单次请求覆盖,任何包含此对象的请求都会被 403 拒绝。如果你的团队强制启用了威胁防护,则不能将 mode 设为 off

timeout
integer
默认值:60000

超时时间(毫秒)

响应

成功响应

data
object[]
id
string

搜索任务的 ID

success
boolean
warning
string | null

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