Skip to main content
POST
执行网页搜索并返回排序结果。
搜索网页,返回排序后的结果。query 必填,limit 控制条数。返回 successcreditsUsed、一个请求 id,以及 data.web[],每条含 urltitledescriptionposition —— 只有标题和摘要,没有页面正文。实测取 2 条约 15 秒,是这里最慢的搜索工具。按 Firecrawl credit 计费,约 ceil(limit / 10) * 2。在 AIsa 计量档位下只支持 web 源,scrapeOptions、企业模式和非 web 源都会被拒绝。什么时候该换:想在同一次调用里拿到正文 —— post_tavily_search 会返回,而且快三倍;已经知道 URL —— post_firecrawl_scrape;希望按语义而不是关键词判断相关性 —— post_exa_search

授权

Authorization
string
header
必填

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

请求体

application/json
query
string
必填

搜索查询词。必须非空,且不超过 500 字符。

Maximum string length: 500
示例:

"firecrawl web scraping api"

limit
integer
默认值:10

返回结果数量的上限。

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

响应

200 - application/json

搜索成功完成。

success
boolean

搜索成功时为 true。

data
object
creditsUsed
integer

消耗的 Firecrawl credits(约每 10 条结果 2 个)。