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

> Remarque : une nouvelle [version v2 de cette API](/fr/api-reference/endpoint/map) est désormais disponible, avec des fonctionnalités et des performances améliorées.


## OpenAPI

````yaml fr/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 permettant d’interagir avec les services Firecrawl pour réaliser des
    tâches de scraping et de crawling web.
  title: Firecrawl API
  version: v1
servers:
  - url: https://api.firecrawl.dev/v1
security:
  - bearerAuth: []
paths:
  /map:
    post:
      tags:
        - Mapping
      summary: Cartographier plusieurs URL selon les options
      operationId: mapUrls
      requestBody:
        content:
          application/json:
            schema:
              properties:
                ignoreSitemap:
                  default: true
                  description: Ignorer le sitemap du site lors de l’exploration.
                  type: boolean
                includeSubdomains:
                  default: true
                  description: Inclure les sous-domaines du site
                  type: boolean
                limit:
                  default: 5000
                  description: Nombre maximal de liens renvoyés
                  maximum: 30000
                  type: integer
                location:
                  description: >-
                    Paramètres de localisation pour la requête. Lorsqu’ils sont
                    spécifiés, un proxy approprié sera utilisé si disponible et
                    les paramètres de langue et de fuseau horaire correspondants
                    seront émulés. La valeur par défaut est « US » si aucun
                    paramètre n’est indiqué.
                  properties:
                    country:
                      default: US
                      description: >-
                        Code de pays ISO 3166-1 alpha-2 (p. ex. « US », « AU »,
                        « DE », « JP »)
                      pattern: ^[A-Z]{2}$
                      type: string
                    languages:
                      description: >-
                        Langues et paramètres régionaux préférés pour la
                        requête, par ordre de priorité. Par défaut, la langue de
                        l’emplacement spécifié est utilisée. Voir
                        https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
                      items:
                        example: en-US
                        type: string
                      type: array
                  type: object
                search:
                  description: >-
                    Requête de recherche à utiliser pour la cartographie.
                    Pendant la phase Alpha, la partie « intelligente » de la
                    fonction de recherche est limitée à 500 résultats. En
                    revanche, si « map » renvoie davantage de résultats, aucune
                    limite n’est appliquée.
                  type: string
                sitemapOnly:
                  default: false
                  description: >-
                    Ne renvoyer que les liens présents dans le sitemap du site
                    web
                  type: boolean
                threatProtection:
                  $ref: '#/components/schemas/ThreatProtectionOverride'
                timeout:
                  description: >-
                    Délai d’expiration en millisecondes. Aucun délai
                    d’expiration n’est défini par défaut.
                  type: integer
                url:
                  description: L’URL de base à partir de laquelle démarrer l’exploration
                  format: uri
                  type: string
              required:
                - url
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapResponse'
          description: Réponse en cas de succès
        '402':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Payment required to access this resource.
                    type: string
                type: object
          description: Paiement requis
        '429':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
                    type: string
                type: object
          description: Trop de requêtes
        '500':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: An unexpected error occurred on the server.
                    type: string
                type: object
          description: Erreur du serveur
      security:
        - bearerAuth: []
components:
  schemas:
    ThreatProtectionOverride:
      description: >-
        Dérogation par requête à la [Protection contre les
        menaces](https://docs.firecrawl.dev/features/threat-protection). Les
        champs que vous fournissez remplacent les champs correspondants de la
        politique de votre organisation pour cette requête uniquement ; les
        champs omis conservent leurs valeurs définies au niveau de
        l’organisation. La Protection contre les menaces doit être activée pour
        votre équipe (fonctionnalité Enterprise) — sinon, la requête est rejetée
        avec un code 403. Si votre organisation a désactivé les dérogations par
        requête, toute requête incluant cet objet est rejetée avec un code 403.
        Si la Protection contre les menaces est imposée pour votre équipe,
        `mode` ne peut pas être défini sur `off`.
      properties:
        blacklist:
          description: >-
            Domaines à toujours bloquer, sous forme de domaines simples
            (`example.com`) ou de jokers (`*.example.com`). Sans protocole,
            chemin ni port.
          items:
            type: string
          maxItems: 1000
          type: array
        blockedTlds:
          description: >-
            Domaines de premier niveau à bloquer systématiquement, en minuscules
            et sans le point initial (par ex. `zip`).
          items:
            type: string
          maxItems: 1000
          type: array
        failurePolicy:
          description: >-
            Comportement à adopter lorsque le classifier est inaccessible :
            `closed` bloque la requête, `open` l’autorise.
          enum:
            - open
            - closed
          type: string
        mode:
          description: >-
            Mode d’analyse des URL pour cette requête. `normal` vérifie les URL
            via Google Web Risk (+2 crédits par URL vérifiée).
          enum:
            - 'off'
            - normal
          type: string
        riskScoreThreshold:
          description: >-
            Score de risque normalisé (0–100) à partir duquel le verdict d’un
            classificateur bloque l’URL. Plus il est faible, plus le seuil est
            strict.
          example: 75
          maximum: 100
          minimum: 0
          type: integer
        whitelist:
          description: >-
            Domaines à toujours autoriser, sous forme de domaines simples ou de
            jokers. Cette règle prévaut sur toutes les autres.
          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

````