从单个 URL 快速生成整站链接地图的最简方式。这在以下场景特别有用：
- 需要让终端用户选择要抓取的链接时
- 需要快速了解网站包含哪些链接
- 需要抓取与特定主题相关的页面（使用
search 参数）
- 只需抓取网站中的特定页面
在 Playground 中试用
在交互式 Playground 中测试映射功能——无需写代码。
sitemap 参数来控制 sitemap 的行为。
# 使用 pip 安装 firecrawl-py
from firecrawl import Firecrawl
firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")
from firecrawl import Firecrawl
firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")
res = firecrawl.map(url="https://firecrawl.dev", limit=50, sitemap="include")
print(res)
每次 map 请求都会消耗 1 个 credit，与返回的 URL 数量无关。例如，即使将 limit 设置为 100,000，也只会使用 1 个 credit。
{
"success": true,
"links": [
{
"url": "https://docs.firecrawl.dev/features/scrape",
"title": "Scrape | Firecrawl",
"description": "将任意 URL 转换为干净的数据",
},
{
"url": "https://www.firecrawl.dev/blog/5_easy_ways_to_access_glm_4_5",
"title": "访问 GLM-4.5 的 5 种简单方式",
"description": "了解如何在本地、通过聊天应用、通过官方 API，以及借助 LLM 市场 API 实现无缝集成地访问 GLM-4.5 模型……",
},
{
"url": "https://www.firecrawl.dev/playground",
"title": "Playground - Firecrawl",
"description": "预览 API 响应并获取该 API 的代码片段",
},
{
"url": "https://www.firecrawl.dev/?testId=2a7e0542-077b-4eff-bec7-0130395570d6",
"title": "Firecrawl - 面向 AI 的 Web 数据 API",
"description": "面向 AI 的网页爬取、抓取与搜索 API，面向规模而构建。Firecrawl 为 AI 代理与构建者提供全网数据：干净、结构化，并且……",
},
{
"url": "https://www.firecrawl.dev/?testId=af391f07-ca0e-40d3-8ff2-b1ecf2e3fcde",
"title": "Firecrawl - 面向 AI 的 Web 数据 API",
"description": "面向 AI 的网页爬取、抓取与搜索 API，面向规模而构建。Firecrawl 为 AI 代理与构建者提供全网数据：干净、结构化，并且……"
},
...
]
}
search 参数的 Map 可在站内搜索特定的 URL。
curl -X POST https://api.firecrawl.dev/v2/map \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{
"url": "https://firecrawl.dev",
"search": "docs"
}'
{
"status": "success",
"links": [
{
"url": "https://docs.firecrawl.dev",
"title": "Firecrawl 文档",
"description": "Firecrawl 文档"
},
{
"url": "https://docs.firecrawl.dev/sdks/python",
"title": "Firecrawl Python SDK",
"description": "Firecrawl Python SDK 文档"
},
...
]
}
location 对象，并设置以下属性：
country：ISO 3166-1 alpha-2 国家代码（如 ‘US’、‘AU’、‘DE’、‘JP’）。默认值为 ‘US’。languages：按优先级排序的首选语言与区域设置数组。默认使用所设位置的语言。
from firecrawl import Firecrawl
firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")
res = firecrawl.map('https://example.com',
location={
'country': 'US',
'languages': ['en']
}
)
print(res)
