Search（搜索）
search 端点将网页搜索与 Firecrawl 的抓取能力相结合，为任意查询返回完整页面内容。
在请求中包含 scrapeOptions，并设置 formats: [{"type": "markdown"}]，即可为每条搜索结果获取完整的 markdown 内容；否则默认只返回结果（url、title、description）。你也可以使用其他 formats，例如 {"type": "summary"} 来获取精简内容。
我们支持多种查询运算符，帮助你更高效地筛选搜索结果。
| 运算符 | 功能 | 示例 |
|---|---|---|
"" | 精确（非模糊）匹配一段文本 | "Firecrawl" |
- | 排除特定关键词或对其他运算符取反 | -bad, -site:firecrawl.dev |
site: | 仅返回来自指定网站的结果 | site:firecrawl.dev |
filetype: | 仅返回具有特定文件扩展名的结果 | filetype:pdf, -filetype:pdf |
inurl: | 仅返回在 URL 中包含某个词的结果 | inurl:firecrawl |
allinurl: | 仅返回在 URL 中包含多个词的结果 | allinurl:git firecrawl |
intitle: | 仅返回在页面标题中包含某个词的结果 | intitle:Firecrawl |
allintitle: | 仅返回在页面标题中包含多个词的结果 | allintitle:firecrawl playground |
related: | 仅返回与特定域相关的结果 | related:firecrawl.dev |
imagesize: | 仅返回尺寸完全匹配的图片 | imagesize:1920x1080 |
larger: | 仅返回大于指定尺寸的图片 | larger:1920x1080 |
使用 location 参数获取按地理位置定向的搜索结果。格式：“string”。示例：“Germany”、“San Francisco,California,United States”。
查看支持的位置完整列表，了解所有可用的国家和语言。
使用 country 参数以 ISO 国家/地区代码指定搜索结果所属国家/地区。默认值：“US”。
示例：“US”、“DE”、“FR”、“JP”、“UK”、“CA”。
{
"query": "餐厅",
"country": "DE"
}使用 categories 参数按特定类别过滤搜索结果：
github: 在 GitHub 仓库、代码、问题和文档中搜索research: 搜索学术和研究类网站（arXiv、Nature、IEEE、PubMed 等）pdf: 搜索 PDF
{
"query": "机器学习",
"categories": ["github", "research"],
"limit": 10
}使用 includeDomains 可将结果限制在特定域名内，或使用 excludeDomains 将特定域名从搜索结果中排除。域名只能填写主机名，不包含协议或路径。
includeDomains 和 excludeDomains 不能同时使用。
{
"query": "web scraping",
"includeDomains": ["firecrawl.dev", "docs.firecrawl.dev"],
"limit": 10
}{
"query": "web scraping tools",
"excludeDomains": ["example.com"],
"limit": 10
}每个结果都包含一个 category 字段，用于表示其来源：
{
"success": true,
"data": {
"web": [
{
"url": "https://github.com/example/ml-project",
"title": "Machine Learning Project",
"description": "Implementation of ML algorithms",
"category": "github"
},
{
"url": "https://arxiv.org/abs/2024.12345",
"title": "ML Research Paper",
"description": "Latest advances in machine learning",
"category": "research"
}
]
}
}使用 tbs 参数按时间范围过滤搜索结果，包括自定义日期区间。详细示例及支持的 formats 请参见 Search Feature 文档。
你是需要 Firecrawl API 密钥的 AI 代理吗？如需自动化入门说明，请参见 firecrawl.dev/agent-onboarding/SKILL.md。