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

# Mapear

> Observação: Uma nova [versão v2 desta API](/pt-BR/api-reference/endpoint/map) já está disponível e oferece recursos e desempenho aprimorados.


## OpenAPI

````yaml pt-BR/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 interagir com os serviços da Firecrawl e realizar tarefas de web
    scraping e crawling.
  title: Firecrawl API
  version: v1
servers:
  - url: https://api.firecrawl.dev/v1
security:
  - bearerAuth: []
paths:
  /map:
    post:
      tags:
        - Mapping
      summary: Mapear várias URLs de acordo com as opções
      operationId: mapUrls
      requestBody:
        content:
          application/json:
            schema:
              properties:
                ignoreSitemap:
                  default: true
                  description: Ignorar o sitemap do site durante o rastreamento.
                  type: boolean
                includeSubdomains:
                  default: true
                  description: Incluir subdomínios do site
                  type: boolean
                limit:
                  default: 5000
                  description: Número máximo de links a retornar
                  maximum: 30000
                  type: integer
                location:
                  description: >-
                    Configurações de localização da requisição. Quando
                    definidas, será usado um proxy apropriado, se disponível, e
                    serão emuladas as configurações correspondentes de idioma e
                    fuso horário. O padrão é "US" se não for especificado.
                  properties:
                    country:
                      default: US
                      description: >-
                        Código de país ISO 3166-1 alfa-2 (por exemplo, "US",
                        "AU", "DE", "JP")
                      pattern: ^[A-Z]{2}$
                      type: string
                    languages:
                      description: >-
                        Idiomas e localidades preferidos para a requisição, em
                        ordem de prioridade. Por padrão, usa o idioma da
                        localidade especificada. Consulte
                        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 pesquisa usada para mapeamento. Durante a fase
                    Alpha, o componente "inteligente" da funcionalidade de
                    pesquisa é limitado a 500 resultados. Porém, se o mapeamento
                    encontrar mais resultados, nenhum limite será aplicado.
                  type: string
                sitemapOnly:
                  default: false
                  description: Retorne apenas os links encontrados no sitemap do site
                  type: boolean
                threatProtection:
                  $ref: '#/components/schemas/ThreatProtectionOverride'
                timeout:
                  description: >-
                    Tempo limite em milissegundos. Não há tempo limite definido
                    por padrão.
                  type: integer
                url:
                  description: A URL base de onde iniciar o rastreamento
                  format: uri
                  type: string
              required:
                - url
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapResponse'
          description: Resposta bem-sucedida
        '402':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Payment required to access this resource.
                    type: string
                type: object
          description: Pagamento obrigatório
        '429':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
                    type: string
                type: object
          description: Muitas solicitações
        '500':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: An unexpected error occurred on the server.
                    type: string
                type: object
          description: Erro de servidor
      security:
        - bearerAuth: []
components:
  schemas:
    ThreatProtectionOverride:
      description: >-
        Substituição por solicitação da [Proteção contra
        ameaças](https://docs.firecrawl.dev/features/threat-protection). Os
        campos fornecidos substituem os campos correspondentes da política da
        sua organização somente para esta solicitação; os campos omitidos mantêm
        os valores definidos no nível da organização. Exige que a Proteção
        contra ameaças esteja ativada para sua equipe (recurso enterprise) —
        caso contrário, a solicitação será rejeitada com 403. Se sua organização
        tiver desativado as substituições por solicitação, qualquer solicitação
        que inclua este objeto será rejeitada com 403. Se a Proteção contra
        ameaças for obrigatória para sua equipe, `mode` não poderá ser definido
        como `off`.
      properties:
        blacklist:
          description: >-
            Domínios a serem sempre bloqueados, como domínios simples
            (`example.com`) ou padrões curinga (`*.example.com`). Sem protocolo,
            caminho ou porta.
          items:
            type: string
          maxItems: 1000
          type: array
        blockedTlds:
          description: >-
            Domínios de nível superior a serem bloqueados diretamente, em
            minúsculas e sem o ponto inicial (ex.: `zip`).
          items:
            type: string
          maxItems: 1000
          type: array
        failurePolicy:
          description: >-
            O que fazer quando o classificador não puder ser acessado: `closed`
            bloqueia a solicitação, `open` a permite.
          enum:
            - open
            - closed
          type: string
        mode:
          description: >-
            Modo de varredura de URL para esta solicitação. `normal` verifica as
            URLs no Google Web Risk (+2 créditos por URL verificada).
          enum:
            - 'off'
            - normal
          type: string
        riskScoreThreshold:
          description: >-
            Pontuação de risco normalizada (0–100) a partir da qual um veredito
            do classificador bloqueia a URL. Quanto menor, mais rigoroso.
          example: 75
          maximum: 100
          minimum: 0
          type: integer
        whitelist:
          description: >-
            Domínios a serem sempre permitidos, como domínios simples ou padrões
            curinga. Tem precedência sobre todas as outras regras.
          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

````