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

```
```


## OpenAPI

````yaml fr/api-reference/v2-openapi.json post /map
openapi: 3.0.0
info:
  title: Firecrawl API
  version: v2
  description: >-
    API pour interagir avec les services Firecrawl afin d’effectuer des tâches
    de scraping et de crawling web.
  contact:
    name: Firecrawl Support
    url: https://firecrawl.dev/support
    email: support@firecrawl.dev
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /map:
    post:
      tags:
        - Mapping
      summary: Mapper plusieurs URL en fonction des options
      operationId: mapUrls
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  format: uri
                  description: L’URL de base à partir de laquelle démarrer le crawl
                search:
                  type: string
                  description: "Spécifiez une requête de recherche pour classer les résultats par pertinence. Exemple\_: «\_blog\_» renverra les URL qui contiennent le mot «\_blog\_» dans leur adresse, classées par pertinence."
                sitemap:
                  type: string
                  enum:
                    - skip
                    - include
                    - only
                  description: >-
                    Mode sitemap lors du mapping. Si vous le réglez sur `skip`,
                    le sitemap ne sera pas utilisé pour trouver des URL. Si vous
                    le réglez sur `only`, seules les URL présentes dans le
                    sitemap seront renvoyées. Par défaut (`include`), le sitemap
                    et d’autres méthodes sont utilisés conjointement pour
                    trouver des URL.
                  default: include
                includeSubdomains:
                  type: boolean
                  description: Inclure les sous-domaines du site
                  default: true
                ignoreQueryParameters:
                  type: boolean
                  description: Ne renvoyez pas d’URL contenant des paramètres de requête
                  default: true
                ignoreCache:
                  type: boolean
                  description: "Ignorez le cache du sitemap pour récupérer les URL les plus récentes. Les données du sitemap sont mises en cache pendant 7\_jours\_; utilisez ce paramètre lorsque votre sitemap a été mis à jour récemment."
                  default: false
                limit:
                  type: integer
                  description: Nombre maximal de liens à retourner
                  default: 5000
                  maximum: 100000
                timeout:
                  type: integer
                  description: >-
                    Délai d’attente en millisecondes. Aucun délai d’attente
                    n’est appliqué par défaut.
                location:
                  type: object
                  description: >-
                    Paramètres de localisation de la requête. Lorsqu’ils sont
                    spécifiés, un proxy approprié est utilisé, si disponible, et
                    les paramètres de langue et de fuseau horaire correspondants
                    sont émulés. La valeur par défaut est « US » si aucun
                    paramètre n’est spécifié.
                  properties:
                    country:
                      type: string
                      description: >-
                        Code de pays ISO 3166-1 alpha-2 (par exemple « US », «
                        AU », « DE », « JP »)
                      pattern: ^[A-Z]{2}$
                      default: US
                    languages:
                      type: array
                      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:
                        type: string
                        example: en-US
              required:
                - url
            examples:
              example1:
                summary: "Exemple\_1"
                value:
                  url: <string>
                  search: <string>
                  sitemap: include
                  includeSubdomains: true
                  ignoreQueryParameters: true
                  ignoreCache: false
                  limit: 5000
                  location:
                    country: US
                    languages:
                      - en-US
                  timeout: 60000
      responses:
        '200':
          description: Réponse réussie
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapResponse'
        '402':
          description: Paiement requis
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Payment required to access this resource.
        '429':
          description: Trop de requêtes
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
        '500':
          description: Erreur du serveur
          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: object
            properties:
              url:
                type: string
                format: uri
              title:
                type: string
                description: Le titre de la page, le cas échéant.
              description:
                type: string
                description: Description de la page, le cas échéant.
            required:
              - url
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````