Search(搜索)
search 端点将网页搜索与 Firecrawl 的抓取能力相结合,为任意查询返回完整页面内容。
在请求中包含 scrapeOptions,并设置 formats: [{"type": "markdown"}],即可为每条搜索结果获取完整的 markdown 内容;否则默认只返回结果 (url、title、description) 。你也可以使用其他 formats,例如 {"type": "summary"} 来获取精简内容。
支持的查询运算符
location 参数
location 参数获取按地理位置定向的搜索结果。格式:“string”。示例:“Germany”、“San Francisco,California,United States”。
查看支持的位置完整列表,了解所有可用的国家和语言。
country 参数
country 参数以 ISO 国家/地区代码指定搜索结果所属国家/地区。默认值:“US”。
示例:“US”、“DE”、“FR”、“JP”、“UK”、“CA”。
Categories 参数
categories 参数按特定类别筛选搜索结果:
github:在 GitHub 仓库、代码、issue 和文档中搜索research:将网页搜索限定为学术和研究网站 (arxiv.org、nature.com、ieee.org、pubmed.ncbi.nlm.nih.gov、biorxiv.org、medrxiv.org 等) 。返回带 snippet 的常规网页结果,而非论文记录pdf:搜索 PDFdeveloper:搜索 Developer Index——包括公开代码仓库中的 issue、已合并的 pull request 和 README,以及精选文档网站
research 是网站筛选条件,不是论文索引。**它会将此端点的网页结果限定在固定的学术域名列表中。如需直接搜索科学文献——包括 PubMed、bioRxiv、medRxiv 和 arXiv 中的论文摘要,以及读取论文内段落和扩展引用图谱——请使用 研究索引 的 GET /search/research/papers。使用示例
域名过滤
includeDomains 可将结果限制在特定域名内,或使用 excludeDomains 将特定域名从搜索结果中排除。域名只能填写主机名,不包含协议或路径。
includeDomains 和 excludeDomains 不能同时使用。
包含域名示例
域名排除示例
分类响应
category 字段,用于表示其来源:
基于时间的搜索
tbs 参数按时间范围过滤搜索结果,包括自定义日期区间。详细示例及支持的 formats 请参见 Search Feature 文档。
你是需要 Firecrawl API 密钥的 AI 代理吗?如需自动化入门说明,请参见 firecrawl.dev/agent-onboarding/SKILL.md。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
搜索查询语句
500根据类别筛选结果。默认值为 [],表示结果不会按类别进行过滤。
- GitHub
- Research
- PDF
用于按地域定向搜索结果的 ISO 国家代码(例如 US)。为获得最佳效果,请同时设置此参数和 location 参数。
用于零数据保留(ZDR)的企业搜索选项。端到端 ZDR 使用 ["zdr"](10 额度 / 10 个结果),匿名化 ZDR 使用 ["anon"](2 额度 / 10 个结果)。必须为你的团队启用。
anon, zdr 排除来自指定域名的搜索结果。域名应仅填写主机名,不包含协议或路径。不能与 includeDomains 一起使用。
为搜索结果生成与 query 相关的高亮内容。设为 false 时,将返回提供方描述或摘要片段,不显示高亮。
从搜索结果中排除对其他 Firecrawl 端点无效的 URL。这样在将搜索结果数据输送到其他 Firecrawl API 端点时,有助于减少错误。
将搜索结果限制在指定域名内。域名应仅填写主机名,不包含协议或路径。不能与 excludeDomains 一起使用。
返回结果的最大数量(使用多个来源时,按每种来源类型分别计算)
1 <= x <= 100用于搜索结果的位置参数(例如 San Francisco,California,United States)。为获得最佳效果,请同时设置该参数和 country 参数。
设为 true 时,会从搜索结果中筛除露骨内容(SafeSearch)。省略此参数将保留默认行为,即不应用该筛选条件。
抓取搜索结果的选项
要搜索的数据源。将决定响应中可用的数组。默认为 ['web']。
- Web
- Images
- News
用于按时间过滤结果的搜索参数。支持预设时间范围(qdr:h、qdr:d、qdr:w、qdr:m、qdr:y)、自定义日期范围(cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY),以及按日期排序(sbd:1)。这些参数值可以组合使用,例如:sbd:1,qdr:w。
超时(毫秒)

