> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer une carte

> Ce point de terminaison permet aux utilisateurs d’obtenir toutes les URLs d’un certain site web. Cela peut prendre jusqu’à 120 secondes pour les sites web complexes. Pour les grands sites web, les résultats sont paginés en utilisant une pagination basée sur le curseur.



## OpenAPI

````yaml fr/openapi/maps.json POST /v1/maps
openapi: 3.0.3
info:
  title: API de Cartes
  version: 1.0.0
servers:
  - url: https://api.olostep.com
security: []
paths:
  /v1/maps:
    post:
      summary: Obtenir toutes les urls sur un certain site web
      description: >-
        Ce point de terminaison permet aux utilisateurs d'obtenir toutes les
        urls sur un certain site web. Cela peut prendre jusqu'à 120 secondes
        pour les sites web complexes. Pour les grands sites web, les résultats
        sont paginés en utilisant une pagination basée sur un curseur.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  format: uri
                  description: L'URL du site web pour lequel tu veux les liens
                search_query:
                  type: string
                  description: >-
                    Une requête de recherche optionnelle pour trier les liens
                    par pertinence de recherche.
                top_n:
                  type: number
                  description: >-
                    Un nombre optionnel pour limiter aux n premiers liens pour
                    une requête de recherche.
                include_subdomain:
                  type: boolean
                  description: >-
                    Inclure les sous-domaines de l'URL donnée. `true` par
                    défaut.
                include_urls:
                  type: array
                  items:
                    type: string
                  description: >-
                    Modèles de chemin d'URL à inclure en utilisant la syntaxe
                    glob. Par exemple : `/blog/**` pour inclure uniquement les
                    URLs de blog. Seules les URLs correspondant à ces modèles
                    seront retournées.
                exclude_urls:
                  type: array
                  items:
                    type: string
                  description: >-
                    Modèles de chemin d'URL à exclure en utilisant la syntaxe
                    glob. Par exemple : `/careers/**`. Les URLs exclues
                    supplanteront les URLs incluses.
                cursor:
                  type: string
                  description: >-
                    OPTIONNEL : Curseur de pagination d'une réponse précédente.
                    Lorsqu'il est fourni, retourne le prochain ensemble d'URLs à
                    partir de l'endroit où la demande précédente s'est arrêtée
                    en raison de la limite de taille de réponse.
              required:
                - url
            examples:
              basic:
                value:
                  url: https://docs.olostep.com
              withFilters:
                value:
                  url: https://docs.olostep.com
                  include_urls:
                    - /api-reference/**
                  exclude_urls:
                    - /api-reference/deprecated/**
              withCursor:
                value:
                  cursor: abc123_xyz456
      responses:
        '200':
          description: Réponse réussie avec les URLs trouvées sur la page
          content:
            application/json:
              schema:
                type: object
                required:
                  - urls_count
                  - urls
                properties:
                  id:
                    type: string
                    description: Identifiant unique pour cette carte
                  urls_count:
                    type: integer
                    description: Nombre d'URLs dans la réponse actuelle
                  urls:
                    type: array
                    items:
                      type: string
                    description: Tableau d'URLs trouvées sur la page
                  cursor:
                    type: string
                    description: >-
                      Curseur de pagination pour récupérer le prochain ensemble
                      d'URLs limité en raison de la limite de taille de 10MB. Si
                      null ou non présent, toutes les URLs ont été récupérées.
                  credits_consumed:
                    type: integer
                    nullable: true
                    description: >-
                      Nombre de crédits consommés par cette requête. Rempli
                      après l'exécution terminée. Les crédits sont la source de
                      vérité pour la facturation.
                  cost_usd:
                    type: number
                    nullable: true
                    description: >-
                      Coût estimé en USD pour cette requête. Rempli après
                      l'exécution terminée. Calculé à partir des crédits
                      consommés et de ton tarif de plan — 99% précis, mais
                      credits_consumed est la valeur faisant autorité.
              examples:
                basicResponse:
                  value:
                    id: map_abc123
                    urls_count: 22
                    urls:
                      - https://docs.olostep.com/api-reference/batches/create
                      - https://docs.olostep.com/api-reference/batches/info
                      - https://docs.olostep.com/api-reference/batches/items
                cursorResponse:
                  value:
                    id: map_abc123
                    urls_count: 15
                    urls:
                      - https://docs.olostep.com/api-reference/crawls/create
                      - https://docs.olostep.com/api-reference/crawls/info
                      - https://docs.olostep.com/api-reference/crawls/pages
                    cursor: abc123_def789
                allRetrievedResponse:
                  value:
                    id: map_abc123
                    urls_count: 10
                    urls:
                      - https://docs.olostep.com/features/maps
                      - https://docs.olostep.com/get-started/authentication
                      - https://docs.olostep.com/get-started/welcome
                    cursor: null
        '400':
          description: Mauvaise requête en raison de paramètres incorrects ou manquants.
        '401':
          description: Accès non autorisé en raison d'un jeton API manquant ou invalide.
        '500':
          description: Erreur interne du serveur.
      security:
        - Authorization: []
components:
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: >-
        En-tête d'authentification Bearer sous la forme Bearer <token>, où
        <token> est ton jeton d'authentification.

````