> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Map

> 注意：本 API 的全新 [v2 版本](/zh/api-reference/endpoint/map) 现已发布，具备更强大的功能和更高的性能。


## OpenAPI

````yaml zh/api-reference/v1-openapi.json POST /map
openapi: 3.0.0
info:
  contact:
    email: support@firecrawl.dev
    name: Firecrawl Support
    url: https://firecrawl.dev/support
  description: 用于与 Firecrawl 服务交互，以进行网页抓取和爬取任务的 API。
  title: Firecrawl API
  version: v1
servers:
  - url: https://api.firecrawl.dev/v1
security:
  - bearerAuth: []
paths:
  /map:
    post:
      tags:
        - Mapping
      summary: 基于选项对多个 URL 进行映射
      operationId: mapUrls
      requestBody:
        content:
          application/json:
            schema:
              properties:
                ignoreSitemap:
                  default: true
                  description: 抓取网站时忽略其 sitemap。
                  type: boolean
                includeSubdomains:
                  default: true
                  description: 包含该网站子域名
                  type: boolean
                limit:
                  default: 5000
                  description: 要返回的最大链接数
                  maximum: 30000
                  type: integer
                location:
                  description: 请求的地理位置设置。指定后（如果可用），将使用相应的代理，并模拟对应的语言和时区设置。如果未指定，默认值为“US”。
                  properties:
                    country:
                      default: US
                      description: ISO 3166-1 alpha-2 国家代码（例如：US、AU、DE、JP）
                      pattern: ^[A-Z]{2}$
                      type: string
                    languages:
                      description: >-
                        请求中按优先级排序的首选语言和区域设置。默认使用指定位置的语言。参见
                        https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
                      items:
                        example: en-US
                        type: string
                      type: array
                  type: object
                search:
                  description: >-
                    用于映射的搜索查询。在 Alpha 阶段，搜索功能中的「智能」部分最多只会处理 500 条搜索结果。不过，如果 Map
                    找到更多结果，则不会对这些结果施加任何限制。
                  type: string
                sitemapOnly:
                  default: false
                  description: 仅返回网站站点地图中包含的链接
                  type: boolean
                threatProtection:
                  $ref: '#/components/schemas/ThreatProtectionOverride'
                timeout:
                  description: 超时时间（毫秒）。默认情况下没有超时限制。
                  type: integer
                url:
                  description: 开始爬取时使用的基础 URL
                  format: uri
                  type: string
              required:
                - url
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapResponse'
          description: 成功响应
        '402':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Payment required to access this resource.
                    type: string
                type: object
          description: 需要付款
        '429':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
                    type: string
                type: object
          description: 请求过于频繁
        '500':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: An unexpected error occurred on the server.
                    type: string
                type: object
          description: 服务器错误
      security:
        - bearerAuth: []
components:
  schemas:
    ThreatProtectionOverride:
      description: >-
        此请求的 [威胁防护](https://docs.firecrawl.dev/features/threat-protection)
        单次请求覆盖配置。你提供的字段只会替换本次请求中组织策略里的对应字段；未提供的字段将保留组织级别的值。你的团队必须已启用威胁防护（企业版功能），否则该请求将被
        403 拒绝。如果你的组织已禁用单次请求覆盖，任何包含此对象的请求都会被 403 拒绝。如果你的团队强制启用了威胁防护，则不能将 `mode`
        设为 `off`。
      properties:
        blacklist:
          description: 始终封禁的域名，可为普通域名（`example.com`）或通配 glob（`*.example.com`）。不包含协议、路径或端口。
          items:
            type: string
          maxItems: 1000
          type: array
        blockedTlds:
          description: 要直接封禁的顶级域名，使用不带前导点的小写形式（例如 `zip`）。
          items:
            type: string
          maxItems: 1000
          type: array
        failurePolicy:
          description: 当无法访问分类器时的处理方式：`closed` 会封禁该请求，`open` 则会允许该请求。
          enum:
            - open
            - closed
          type: string
        mode:
          description: >-
            此请求的 URL 扫描模式。`normal` 会根据 Google Web Risk 检查 URL（每扫描一个 URL 额外消耗 2
            点额度）。
          enum:
            - 'off'
            - normal
          type: string
        riskScoreThreshold:
          description: 标准化风险分数阈值（0–100）：当分类器判定结果达到或超过该值时，URL 会被封禁。值越低，限制越严格。
          example: 75
          maximum: 100
          minimum: 0
          type: integer
        whitelist:
          description: 始终允许的域名，可为普通域名或通配 glob。其优先级高于其他所有规则。
          items:
            type: string
          maxItems: 1000
          type: array
      title: Threat Protection Override
      type: object
    MapResponse:
      properties:
        links:
          items:
            type: string
          type: array
        success:
          type: boolean
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````