> ## Documentation Index
> Fetch the complete documentation index at: https://student-213fb9fc.mintlify.site/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:
  title: Firecrawl API
  version: v1
  description: 用于与 Firecrawl 服务交互，以进行网页抓取和爬取任务的 API。
  contact:
    name: Firecrawl Support
    url: https://firecrawl.dev/support
    email: support@firecrawl.dev
servers:
  - url: https://api.firecrawl.dev/v1
security:
  - bearerAuth: []
paths:
  /map:
    post:
      tags:
        - Mapping
      summary: 基于选项对多个 URL 进行映射
      operationId: mapUrls
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  format: uri
                  description: 开始爬取时使用的基础 URL
                search:
                  type: string
                  description: >-
                    用于映射的搜索查询。在 Alpha 阶段，搜索功能中的「智能」部分最多只会处理 500 条搜索结果。不过，如果 Map
                    找到更多结果，则不会对这些结果施加任何限制。
                ignoreSitemap:
                  type: boolean
                  description: 抓取网站时忽略其 sitemap。
                  default: true
                sitemapOnly:
                  type: boolean
                  description: 仅返回网站站点地图中包含的链接
                  default: false
                includeSubdomains:
                  type: boolean
                  description: 包含该网站子域名
                  default: true
                limit:
                  type: integer
                  description: 要返回的最大链接数
                  default: 5000
                  maximum: 30000
                timeout:
                  type: integer
                  description: 超时时间（毫秒）。默认情况下没有超时限制。
                location:
                  type: object
                  description: 请求的地理位置设置。指定后（如果可用），将使用相应的代理，并模拟对应的语言和时区设置。如果未指定，默认值为“US”。
                  properties:
                    country:
                      type: string
                      description: ISO 3166-1 alpha-2 国家代码（例如：US、AU、DE、JP）
                      pattern: ^[A-Z]{2}$
                      default: US
                    languages:
                      type: array
                      description: >-
                        请求中按优先级排序的首选语言和区域设置。默认使用指定位置的语言。参见
                        https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
                      items:
                        type: string
                        example: en-US
              required:
                - url
      responses:
        '200':
          description: 成功响应
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapResponse'
        '402':
          description: 需要付款
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Payment required to access this resource.
        '429':
          description: 请求过于频繁
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
        '500':
          description: 服务器错误
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: An unexpected error occurred on the server.
      security:
        - bearerAuth: []
components:
  schemas:
    MapResponse:
      type: object
      properties:
        success:
          type: boolean
        links:
          type: array
          items:
            type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````