> ## 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.

# Mapa

> Nota: Ya está disponible una nueva [versión v2 de esta API](/es/api-reference/endpoint/map) con funciones y rendimiento mejorados.


## OpenAPI

````yaml es/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: >-
    API para interactuar con los servicios de Firecrawl y realizar tareas de
    scraping y rastreo web.
  title: Firecrawl API
  version: v1
servers:
  - url: https://api.firecrawl.dev/v1
security:
  - bearerAuth: []
paths:
  /map:
    post:
      tags:
        - Mapping
      summary: Mapear varias URL en función de las opciones
      operationId: mapUrls
      requestBody:
        content:
          application/json:
            schema:
              properties:
                ignoreSitemap:
                  default: true
                  description: Ignorar el mapa del sitio web al rastrear.
                  type: boolean
                includeSubdomains:
                  default: true
                  description: Incluir subdominios del sitio web
                  type: boolean
                limit:
                  default: 5000
                  description: Número máximo de enlaces que se devolverán
                  maximum: 30000
                  type: integer
                location:
                  description: >-
                    Configuración de ubicación de la solicitud. Si se
                    especifica, usará un proxy adecuado si está disponible y
                    emulará la configuración de idioma y zona horaria
                    correspondientes. De forma predeterminada, se usa 'US' si no
                    se especifica.
                  properties:
                    country:
                      default: US
                      description: >-
                        Código de país ISO 3166-1 alfa-2 (por ejemplo, "US",
                        "AU", "DE", "JP")
                      pattern: ^[A-Z]{2}$
                      type: string
                    languages:
                      description: >-
                        Idiomas y configuraciones regionales preferidos de la
                        solicitud, en orden de prioridad. Por defecto, se usa el
                        idioma de la ubicación especificada. Consulta
                        https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
                      items:
                        example: en-US
                        type: string
                      type: array
                  type: object
                search:
                  description: >-
                    Consulta de búsqueda que se utilizará para el mapeo. Durante
                    la fase alfa, la parte «inteligente» de la funcionalidad de
                    búsqueda está limitada a 500 resultados. Sin embargo, si map
                    encuentra más resultados, no se impone ningún límite.
                  type: string
                sitemapOnly:
                  default: false
                  description: >-
                    Devuelve únicamente los enlaces encontrados en el mapa del
                    sitio web
                  type: boolean
                threatProtection:
                  $ref: '#/components/schemas/ThreatProtectionOverride'
                timeout:
                  description: >-
                    Tiempo de espera en milisegundos. No hay tiempo de espera
                    por defecto.
                  type: integer
                url:
                  description: La URL base desde la que se iniciará el rastreo
                  format: uri
                  type: string
              required:
                - url
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapResponse'
          description: Respuesta satisfactoria
        '402':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Payment required to access this resource.
                    type: string
                type: object
          description: Se requiere pago
        '429':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
                    type: string
                type: object
          description: Demasiadas peticiones
        '500':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: An unexpected error occurred on the server.
                    type: string
                type: object
          description: Error del servidor
      security:
        - bearerAuth: []
components:
  schemas:
    ThreatProtectionOverride:
      description: >-
        Anulación por solicitud de [Protección contra
        amenazas](https://docs.firecrawl.dev/features/threat-protection). Los
        campos que proporciones reemplazan los campos correspondientes de la
        política de tu organización solo para esta solicitud; los campos
        omitidos conservan sus valores a nivel de organización. Requiere que
        Protección contra amenazas esté habilitada para tu equipo (función
        Enterprise); de lo contrario, la solicitud se rechaza con un 403. Si tu
        organización ha deshabilitado las anulaciones por solicitud, cualquier
        solicitud que incluya este objeto se rechaza con un 403. Si Protección
        contra amenazas se aplica de forma obligatoria para tu equipo, `mode` no
        puede establecerse en `off`.
      properties:
        blacklist:
          description: >-
            Dominios que siempre se bloquearán, como dominios simples
            (`example.com`) o patrones comodín (`*.example.com`). Sin protocolo,
            ruta ni puerto.
          items:
            type: string
          maxItems: 1000
          type: array
        blockedTlds:
          description: >-
            Dominios de nivel superior que se bloquean directamente, en
            minúsculas y sin el punto inicial (p. ej., `zip`).
          items:
            type: string
          maxItems: 1000
          type: array
        failurePolicy:
          description: >-
            Qué hacer cuando no se puede contactar con el clasificador: `closed`
            bloquea la solicitud, `open` la permite.
          enum:
            - open
            - closed
          type: string
        mode:
          description: >-
            Modo de análisis de URL para esta solicitud. `normal` comprueba las
            URL con Google Web Risk (+2 créditos por cada URL analizada).
          enum:
            - 'off'
            - normal
          type: string
        riskScoreThreshold:
          description: >-
            Puntuación de riesgo normalizada (0–100) a partir de la cual un
            veredicto del clasificador bloquea la URL. Cuanto más bajo sea el
            valor, más estricto será.
          example: 75
          maximum: 100
          minimum: 0
          type: integer
        whitelist:
          description: >-
            Dominios que siempre se permitirán, como dominios simples o patrones
            comodín. Tiene prioridad sobre cualquier otra regla.
          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

````