> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-capy-docs-factual-copy-fixes.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Parse

Téléversez un document local ou non public et convertissez-le en données propres, prêtes pour le LLM. `/parse` accepte le fichier via `multipart/form-data` et renvoie du Markdown, du JSON, du HTML, des liens, des images ou un résumé, tout en préservant l’ordre de lecture et les tableaux.

* Convertissez des PDF, Word, Excel, PowerPoint, OpenDocument, EPUB, CSV, HTML et bien plus en Markdown ou en JSON structuré
* Jusqu’à **5x plus rapide** grâce à un moteur Rust
* Jusqu’à **50 MB** par requête
* Prise en charge du Zero Data Retention

<h2 id="when-to-use-parse">
  Quand utiliser `/parse`
</h2>

Utilisez `/parse` lorsque le document source est **un fichier local** ou **n’est pas accessible publiquement via une URL**. Si vous disposez d’une URL publique pointant vers un document, privilégiez [`/scrape`](/fr/api-reference/endpoint/scrape) — ce point de terminaison détecte automatiquement le type de fichier à partir de l’extension ou du type de contenu et l’analyse de la même façon.

| Source | Point de terminaison |
| - | - |
| URL publique pointant vers un document (par ex. `https://example.com/report.pdf`) | [`POST /scrape`](/fr/api-reference/endpoint/scrape) |
| Fichier local ou données binaires non publiques (PDF, DOCX, XLSX, HTML, …) | `POST /parse` (ce point de terminaison) |

<Tip>
  **Vous utilisez Firecrawl via MCP ?** Utilisez `firecrawl_parse` pour les fichiers locaux. MCP local peut lire le fichier directement lorsqu’il est configuré avec `FIRECRAWL_API_URL`. Le MCP distant hébergé renvoie d’abord une commande d’upload temporaire, puis analyse l’`uploadRef` renvoyé. Les URL publiques de documents doivent toujours utiliser `/scrape`.
</Tip>


## OpenAPI

````yaml fr/api-reference/v2-openapi.json POST /parse
openapi: 3.0.0
info:
  contact:
    email: support@firecrawl.dev
    name: Firecrawl Support
    url: https://firecrawl.dev/support
  description: >-
    API pour interagir avec les services Firecrawl afin d’effectuer des tâches
    de scraping et de crawling web.
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /parse:
    post:
      tags:
        - Scraping
      summary: Téléverser et analyser un fichier
      operationId: parseFile
      requestBody:
        content:
          multipart/form-data:
            encoding:
              options:
                contentType: application/json
            schema:
              properties:
                file:
                  description: "Les octets du fichier à analyser. Extensions prises en charge\_: .html, .htm, .xhtml, .pdf, .docx, .doc, .docm, .odt, .ods, .odp, .rtf, .xlsx, .xls, .xlsm, .xlsb, .pptx, .ppt, .pptm, .epub, .csv."
                  format: binary
                  type: string
                options:
                  $ref: '#/components/schemas/ParseOptions'
              required:
                - file
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScrapeResponse'
          description: Réponse réussie
        '400':
          content:
            application/json:
              schema:
                properties:
                  code:
                    example: BAD_REQUEST
                    type: string
                  error:
                    example: Invalid multipart form-data request.
                    type: string
                  success:
                    example: false
                    type: boolean
                type: object
          description: Requête invalide
        '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:
                  code:
                    example: UNKNOWN_ERROR
                    type: string
                  error:
                    example: An unexpected error occurred on the server.
                    type: string
                  success:
                    example: false
                    type: boolean
                type: object
          description: Erreur serveur
      security:
        - bearerAuth: []
components:
  schemas:
    ParseOptions:
      description: >-
        Options d’analyse facultatives envoyées au format JSON dans le champ
        multipart `options`.
      properties:
        auditMetadata:
          $ref: '#/components/schemas/AuditMetadata'
        blockAds:
          default: true
          description: >-
            Activer le blocage des publicités et des fenêtres contextuelles de
            cookies.
          type: boolean
        checkPromptInjection:
          default: false
          description: >-
            Lorsque cette option est activée, le contenu traité est analysé pour
            détecter les tentatives d’injection de prompt avant la génération de
            tout format reposant sur un LLM (tel que json, summary ou question).
            Si une injection est détectée, la requête échoue avec un statut 403
            et le code d’erreur SCRAPE_PROMPT_INJECTION_DETECTED. La
            vérification coûte 4 crédits supplémentaires lorsqu’elle est
            exécutée. Si elle ne peut pas analyser l’intégralité du contenu, le
            traitement se poursuit avec un avertissement et la vérification
            n’est pas facturée.
          type: boolean
        excludeTags:
          description: Balises à exclure de la sortie.
          items:
            type: string
          type: array
        formats:
          $ref: '#/components/schemas/ParseFormats'
        headers:
          description: >-
            En-têtes à envoyer lorsque des requêtes réseau supplémentaires sont
            nécessaires.
          type: object
        includeTags:
          description: Balises à inclure dans la sortie.
          items:
            type: string
          type: array
        integration:
          description: Identifiant d’intégration facultatif.
          nullable: true
          type: string
        onlyMainContent:
          default: true
          description: >-
            Retourner uniquement le contenu principal de la page, en excluant
            les en-têtes, la navigation, les pieds de page, etc.
          type: boolean
        origin:
          default: api
          description: Identifiant d’origine à des fins d’analyse et de journalisation.
          type: string
        parsers:
          default:
            - pdf
          description: >-
            Contrôle le comportement de l’analyseur de fichiers lorsque
            nécessaire (par exemple, le mode d’analyse PDF).
          items:
            oneOf:
              - additionalProperties: false
                properties:
                  blocks:
                    default: false
                    description: "Inclut les blocs de mise en page typés de chaque page avec le Markdown du document. Renseigne le champ `blocks` du document\_: blocs typés (title, section_header, text, table, formula, figure, caption, ...) avec boîtes englobantes normalisées, ordre de lecture, liens par plage de caractères vers le Markdown et niveau de confiance par bloc. Aucun coût supplémentaire."
                    type: boolean
                  maxPages:
                    description: Nombre maximal de pages à analyser dans le PDF.
                    maximum: 10000
                    minimum: 1
                    type: integer
                  mode:
                    default: auto
                    description: "Mode d’analyse PDF. \"fast\"\_: extraction de texte uniquement. \"auto\"\_: texte d’abord, avec OCR en secours. \"ocr\"\_: OCR sur chaque page."
                    enum:
                      - fast
                      - auto
                      - ocr
                    type: string
                  pageMarkers:
                    default: false
                    description: "Ajoute des annotations aux sauts de page dans le Markdown du document\_: les pages sont séparées par `\\n\\n---\\n\\n<!-- page N -->\\n\\n`, où N est le numéro, à partir de 1, de la page physique contenant le contenu qui suit. Les marqueurs n’apparaissent qu’entre les pages (aucun marqueur avant la page\_1) et la numérotation peut ignorer des pages fusionnées de part et d’autre d’un saut de page\_; utilisez `pages: true` lorsque chaque page physique est requise. Aucun nouveau champ dans la réponse\_; aucun coût supplémentaire."
                    type: boolean
                  pages:
                    default: false
                    description: >-
                      Inclut le Markdown physique de chaque page avec le
                      Markdown du document. Renseigne le champ `pages` du
                      document sous forme de tableau de { pageNumber, markdown
                      }. Aucun coût supplémentaire.
                    type: boolean
                  type:
                    enum:
                      - pdf
                    type: string
                required:
                  - type
                type: object
          type: array
        proxy:
          description: >-
            Mode proxy pour les téléversements `/parse`. `/parse` prend en
            charge uniquement `basic` et `auto`.
          enum:
            - basic
            - auto
          type: string
        redactPII:
          default: false
          description: >-
            Masquez les données personnelles identifiables dans le markdown
            renvoyé. Passez `true` pour utiliser les valeurs par défaut, ou un
            objet pour ajuster le mode, les entités et le style de remplacement.
          oneOf:
            - type: boolean
            - $ref: '#/components/schemas/RedactPIIOptions'
        removeBase64Images:
          default: true
          description: >-
            Supprimer les images encodées en base64 de la sortie et conserver
            les espaces réservés du texte alternatif.
          type: boolean
        skipTlsVerification:
          default: true
          description: >-
            Ignorer la vérification du certificat TLS lors de l’envoi des
            requêtes.
          type: boolean
        timeout:
          default: 30000
          description: >-
            Délai d’expiration en millisecondes pour la requête. La valeur par
            défaut est de 30000 (30 secondes). Le maximum est de 300000 (300
            secondes).
          maximum: 300000
          type: integer
        zeroDataRetention:
          default: false
          description: >-
            Si la valeur est true, cela activera Zero Data Retention pour cette
            analyse. Pour activer cette fonctionnalité, veuillez contacter
            help@firecrawl.dev
          type: boolean
      type: object
    ScrapeResponse:
      properties:
        data:
          properties:
            actions:
              description: >-
                Résultats des actions spécifiées via le paramètre `actions`.
                Uniquement présent si ce paramètre a été fourni dans la requête
              nullable: true
              properties:
                javascriptReturns:
                  description: >-
                    Valeurs renvoyées par JavaScript, dans le même ordre que les
                    actions executeJavascript fournies.
                  items:
                    properties:
                      type:
                        type: string
                      value: {}
                    type: object
                  type: array
                pdfs:
                  description: >-
                    PDF générés, dans le même ordre que les actions PDF
                    fournies.
                  items:
                    type: string
                  type: array
                scrapes:
                  description: >-
                    Extraire le contenu dans le même ordre que les actions de
                    scraping fournies.
                  items:
                    properties:
                      html:
                        type: string
                      url:
                        type: string
                    type: object
                  type: array
                screenshots:
                  description: >-
                    URLs des captures d’écran, dans le même ordre que les
                    actions de capture d’écran indiquées.
                  items:
                    format: url
                    type: string
                  type: array
              type: object
            answer:
              description: >-
                Réponse en langage naturel à la question fournie via le format
                `question`. Présente uniquement si un objet de format `question`
                a été inclus dans `formats`.
              nullable: true
              type: string
            audio:
              description: >-
                URL signée du fichier audio MP3 extrait si `audio` est présent
                dans `formats`. L’URL signée expire au bout d’une heure.
              nullable: true
              type: string
            blocks:
              description: >-
                Blocs de mise en page typés de chaque page pour les PDF.
                Présents uniquement lorsque la requête a défini l’option
                `blocks` du parseur PDF.
              items:
                properties:
                  height:
                    description: >-
                      Hauteur de rendu de la page en px. Null pour les pages qui
                      n’ont jamais été rendues.
                    nullable: true
                    type: number
                  items:
                    items:
                      properties:
                        bbox:
                          description: >-
                            [x0, y0, x1, y1] normalisé entre 0 et 1 par rapport
                            à la largeur/hauteur de la page. Multipliez par la
                            largeur/hauteur de la page pour obtenir les
                            coordonnées en pixels. Null lorsque les dimensions
                            de la page sont inconnues.
                          items:
                            type: number
                          maxItems: 4
                          minItems: 4
                          nullable: true
                          type: array
                        confidence:
                          properties:
                            layout:
                              description: >-
                                Score de détection du modèle de mise en page
                                (0-1). Null lorsque la page a ignoré l’analyse
                                de mise en page.
                              nullable: true
                              type: number
                            ocr:
                              description: "Niveau de confiance du texte lorsque le chemin source en fournit un\_; null sinon."
                              nullable: true
                              type: number
                          type: object
                        content:
                          description: >-
                            Fragment Markdown ajouté par ce bloc au Markdown du
                            document.
                          type: string
                        id:
                          description: "Stable au sein d’une réponse\_: p<page>.b<index dans l’ordre de lecture>."
                          type: string
                        label:
                          description: >-
                            Libellé brut du modèle de mise en page, transmis tel
                            quel pour assurer la compatibilité ascendante.
                          nullable: true
                          type: string
                        markdownSpan:
                          description: >-
                            Décalages de caractères [start, end) dans le
                            Markdown du document couvrant le fragment de ce
                            bloc. Null lorsqu’une transformation de
                            post-traitement a réécrit le fragment.
                          items:
                            type: integer
                          maxItems: 2
                          minItems: 2
                          nullable: true
                          type: array
                        readingOrder:
                          type: integer
                        source:
                          description: >-
                            Chemin du pipeline ayant produit le bloc (par
                            exemple native_text, layout_ocr, tsr, formula_model,
                            full_page).
                          nullable: true
                          type: string
                        type:
                          description: "Type de bloc\_: title, section_header, text, table, formula, figure, caption, page_number, page_header, page_footer. De nouveaux types peuvent apparaître au fil du temps."
                          type: string
                      type: object
                    type: array
                  pageNumber:
                    description: Numéro de page PDF physique, indexé à partir de 1.
                    type: integer
                  status:
                    description: "Statut global de la page\_: ok | partial | failed."
                    type: string
                  width:
                    description: >-
                      Largeur de rendu de la page en px — référence pour
                      dénormaliser les coordonnées bbox. Null pour les pages qui
                      n’ont jamais été rendues.
                    nullable: true
                    type: number
                type: object
              nullable: true
              type: array
            branding:
              description: >-
                Informations de branding extraites de la page si `branding`
                figure dans `formats`. Inclut les couleurs, les polices, la
                typographie, l’espacement, les composants, et plus encore.
              nullable: true
              properties:
                animations:
                  description: Paramètres d’animation et de transition.
                  nullable: true
                  type: object
                colorScheme:
                  description: Palette de couleurs détectée sur la page.
                  enum:
                    - light
                    - dark
                  type: string
                colors:
                  description: Couleurs de la marque extraites à partir de la page.
                  nullable: true
                  properties:
                    accent:
                      description: Couleur d’accent (hex).
                      type: string
                    background:
                      description: Couleur d’arrière-plan (hex).
                      type: string
                    error:
                      description: Couleur d’erreur/de danger (hex).
                      type: string
                    link:
                      description: Couleur des liens (hex).
                      type: string
                    primary:
                      description: Couleur principale de la marque (hex).
                      type: string
                    secondary:
                      description: Couleur secondaire de la marque (hex).
                      type: string
                    success:
                      description: Couleur de succès/état positif (hex).
                      type: string
                    textPrimary:
                      description: Couleur principale du texte (hex).
                      type: string
                    textSecondary:
                      description: Couleur secondaire du texte (hex).
                      type: string
                    warning:
                      description: Couleur d’avertissement (hex).
                      type: string
                  type: object
                components:
                  description: Styles des composants d’interface (UI).
                  nullable: true
                  properties:
                    buttonPrimary:
                      description: Styles des boutons principaux (boutons primaires).
                      properties:
                        background:
                          type: string
                        borderRadius:
                          type: string
                        textColor:
                          type: string
                      type: object
                    buttonSecondary:
                      description: Styles pour les boutons secondaires.
                      properties:
                        background:
                          type: string
                        borderColor:
                          type: string
                        borderRadius:
                          type: string
                        textColor:
                          type: string
                      type: object
                    input:
                      description: Styles des champs de saisie.
                      type: object
                  type: object
                fonts:
                  description: Tableau des familles de polices utilisées sur la page.
                  items:
                    properties:
                      family:
                        description: Nom de la famille de polices.
                        type: string
                    type: object
                  nullable: true
                  type: array
                icons:
                  description: Styles des icônes.
                  nullable: true
                  type: object
                images:
                  description: Images de marque.
                  nullable: true
                  properties:
                    favicon:
                      description: URL du favicon.
                      type: string
                    logo:
                      description: URL de l’image du logo.
                      type: string
                    ogImage:
                      description: URL de l’image Open Graph.
                      type: string
                  type: object
                layout:
                  description: >-
                    Configuration de la mise en page (grille, hauteurs d’en-tête
                    et de pied de page).
                  nullable: true
                  type: object
                logo:
                  description: URL du logo principal.
                  nullable: true
                  type: string
                personality:
                  description: >-
                    Caractéristiques de la personnalité de la marque (ton,
                    énergie, audience cible).
                  nullable: true
                  type: object
                spacing:
                  description: Paramètres d’espacement et de mise en page.
                  nullable: true
                  properties:
                    baseUnit:
                      description: Unité de base d’espacement en pixels.
                      type: integer
                    borderRadius:
                      description: Rayon de bordure (border-radius) par défaut.
                      type: string
                    margins:
                      description: Valeurs de marge (margin).
                      type: object
                    padding:
                      description: Valeurs de remplissage (padding).
                      type: object
                  type: object
                typography:
                  description: Informations détaillées sur la typographie.
                  nullable: true
                  properties:
                    fontFamilies:
                      description: Familles de polices par rôle.
                      properties:
                        code:
                          description: >-
                            Famille de polices pour le code/police à chasse fixe
                            (monospace).
                          type: string
                        heading:
                          description: Famille de polices des titres.
                          type: string
                        primary:
                          description: Famille de polices principale.
                          type: string
                      type: object
                    fontSizes:
                      description: >-
                        Tailles de police pour les différents niveaux
                        typographiques.
                      properties:
                        body:
                          type: string
                        h1:
                          type: string
                        h2:
                          type: string
                        h3:
                          type: string
                      type: object
                    fontWeights:
                      description: Définition des graisses de police.
                      properties:
                        bold:
                          type: integer
                        light:
                          type: integer
                        medium:
                          type: integer
                        regular:
                          type: integer
                      type: object
                    lineHeights:
                      description: Valeurs d’interligne pour les différents types de texte.
                      properties:
                        body:
                          type: string
                        heading:
                          type: string
                      type: object
                  type: object
              type: object
            changeTracking:
              description: >-
                Informations de suivi des modifications si `changeTracking`
                figure dans `formats`. Uniquement présent lorsque le format
                `changeTracking` est demandé.
              nullable: true
              properties:
                changeStatus:
                  description: >-
                    Le résultat de la comparaison entre les deux versions de la
                    page. « new » signifie que cette page n’existait pas
                    auparavant, « same » indique que le contenu n’a pas changé,
                    « changed » indique que le contenu a été modifié, « removed
                    » signifie que la page a été supprimée.
                  enum:
                    - new
                    - same
                    - changed
                    - removed
                  type: string
                diff:
                  description: >-
                    Diff des modifications au format Git lors de l’utilisation
                    du mode « git-diff ». Uniquement présent lorsque le mode est
                    activé sur « git-diff ».
                  nullable: true
                  type: string
                json:
                  description: >-
                    Résultats de comparaison JSON lors de l’utilisation du mode
                    `json`. Uniquement disponible lorsque le mode est défini sur
                    `json`. Produit une liste de toutes les clés et de leurs
                    valeurs à partir des extractions `previous` et `current`, en
                    fonction du type défini dans le `schema`. Exemple
                    [ici](/features/change-tracking)
                  nullable: true
                  type: object
                previousScrapeAt:
                  description: >-
                    L’horodatage du précédent scrape auquel la page actuelle est
                    comparée. Null s’il n’y a eu aucun scrape précédent.
                  format: date-time
                  nullable: true
                  type: string
                visibility:
                  description: >-
                    La visibilité de la page/URL actuelle. « visible » signifie
                    que l’URL a été découverte via une voie organique (liens ou
                    sitemap), « hidden » signifie que l’URL a été découverte à
                    partir de la mémoire de crawls précédents.
                  enum:
                    - visible
                    - hidden
                  type: string
              type: object
            highlights:
              description: >-
                Texte source pertinent sélectionné par le format `highlights`.
                Présent uniquement si un objet de format `highlights` a été
                inclus dans `formats`.
              nullable: true
              type: string
            html:
              description: "Version HTML nettoyée de la page si `html` figure dans `formats`. Supprime les balises `<script>`, `<style>`, `<noscript>`, `<meta>` et `<head>`\_; convertit les URL relatives en URL absolues\_; résout les attributs `srcset` des images responsives vers leur plus grande version. Respecte les filtres `onlyMainContent`, `includeTags` et `excludeTags`."
              nullable: true
              type: string
            links:
              description: Liste des liens sur la page si `links` fait partie de `formats`
              items:
                type: string
              type: array
            markdown:
              type: string
            menu:
              description: >-
                Informations de menu extraites de la page si `menu` figure dans
                `formats`. Inclut l’établissement, la devise et une liste de
                sections, chaque section contenant des éléments avec
                description, images, prix, disponibilité, tags alimentaires,
                calories et groupes d’options.
              nullable: true
              properties:
                confidence:
                  description: >-
                    Un score de confiance entre 0 et 1 pour l’extraction du
                    menu.
                  type: number
                currency:
                  description: >-
                    Le code devise ISO 4217 du menu (par ex. 'USD'), renvoyé
                    uniquement lorsque la page le fournit.
                  type: string
                isMenu:
                  description: Indique si la page a été identifiée comme un menu.
                  type: boolean
                merchant:
                  description: L’établissement auquel appartient le menu.
                  properties:
                    name:
                      description: Le nom de l’établissement.
                      type: string
                    type:
                      description: Le type d’établissement (par ex. 'restaurant').
                      type: string
                  required:
                    - name
                  type: object
                sections:
                  description: Sections du menu (par ex. 'Entrées', 'Plats').
                  items:
                    properties:
                      description:
                        description: La description de la section.
                        nullable: true
                        type: string
                      id:
                        description: L’identifiant de la section.
                        type: string
                      items:
                        description: Les éléments de la section.
                        items:
                          properties:
                            availability:
                              description: La disponibilité de l’élément.
                              properties:
                                inStock:
                                  description: Indique si l’élément est disponible.
                                  type: boolean
                                text:
                                  description: >-
                                    Texte de disponibilité lisible par une
                                    personne.
                                  nullable: true
                                  type: string
                              required:
                                - inStock
                              type: object
                            calories:
                              description: Le nombre de calories de l’élément.
                              nullable: true
                              type: number
                            description:
                              description: La description de l’élément.
                              nullable: true
                              type: string
                            dietary:
                              description: >-
                                Tags alimentaires de l’élément (par ex.
                                ['vegetarian']).
                              items:
                                type: string
                              type: array
                            id:
                              description: L’identifiant de l’élément.
                              type: string
                            identifiers:
                              description: >-
                                Les identifiants propres à l’établissement pour
                                l’élément.
                              properties:
                                merchantItemId:
                                  description: >-
                                    L’identifiant interne de l’établissement
                                    pour l’élément.
                                  type: string
                              type: object
                            images:
                              description: Images de l’élément.
                              items:
                                properties:
                                  alt:
                                    description: Texte alternatif de l’image.
                                    nullable: true
                                    type: string
                                  url:
                                    description: URL de l’image.
                                    type: string
                                required:
                                  - url
                                type: object
                              type: array
                            name:
                              description: Le nom de l’élément.
                              type: string
                            optionGroups:
                              description: >-
                                Les groupes d’options/modificateurs de
                                l’élément.
                              items:
                                type: object
                              type: array
                            price:
                              description: Le prix de l’élément.
                              properties:
                                amount:
                                  description: Le montant numérique du prix.
                                  type: number
                                currency:
                                  description: Le code devise ISO 4217 (par ex. 'USD').
                                  type: string
                                formatted:
                                  description: >-
                                    Le prix formaté pour l’affichage (par ex.
                                    '$7.99').
                                  type: string
                              required:
                                - amount
                              type: object
                            sourceUrl:
                              description: >-
                                L’URL à partir de laquelle l’élément a été
                                extrait.
                              nullable: true
                              type: string
                            url:
                              description: L’URL canonique de l’élément.
                              nullable: true
                              type: string
                          required:
                            - name
                          type: object
                        type: array
                      name:
                        description: Le nom de la section.
                        type: string
                    required:
                      - name
                      - items
                    type: object
                  type: array
                sourceUrl:
                  description: L’URL à partir de laquelle le menu a été extrait.
                  nullable: true
                  type: string
              required:
                - isMenu
                - sections
              type: object
            metadata:
              properties:
                '<any other metadata> ':
                  description: >-
                    Autres métadonnées extraites du HTML, sous forme de chaîne
                    ou de tableau de chaînes
                  oneOf:
                    - type: string
                    - items:
                        type: string
                      type: array
                concurrencyLimited:
                  description: >-
                    Indique si ce scrape a été ralenti en raison des limites de
                    concurrence de l’Équipe
                  type: boolean
                concurrencyQueueDurationMs:
                  description: >-
                    Temps d’attente de la requête dans la file de concurrence,
                    en millisecondes. Présent uniquement lorsque
                    concurrencyLimited est défini sur true.
                  type: number
                contentType:
                  description: >-
                    Le type de contenu (type MIME) de la page, par exemple
                    text/html, application/pdf
                  type: string
                description:
                  description: >-
                    Description extraite de la page, peut être une chaîne de
                    caractères ou un tableau de chaînes de caractères
                  oneOf:
                    - type: string
                    - items:
                        type: string
                      type: array
                error:
                  description: Le message d’erreur de la page
                  nullable: true
                  type: string
                keywords:
                  description: >-
                    Mots-clés extraits de la page, sous forme d’une chaîne ou
                    d’un tableau de chaînes
                  oneOf:
                    - type: string
                    - items:
                        type: string
                      type: array
                language:
                  description: >-
                    Langue extraite de la page, peut être une chaîne ou un
                    tableau de chaînes de caractères
                  nullable: true
                  oneOf:
                    - type: string
                    - items:
                        type: string
                      type: array
                numPages:
                  description: >-
                    Pour les fichiers PDF, le nombre de pages traitées (limité
                    par l’option maxPages du parser).
                  type: integer
                ogLocaleAlternate:
                  description: Autres paramètres régionaux pour la page
                  items:
                    type: string
                  type: array
                provider:
                  description: >-
                    Défini lorsqu’un provider de données tiers a fourni le
                    contenu de l’URL.
                  properties:
                    creditsCost:
                      description: Le coût de cet accès, en crédits.
                      type: integer
                    id:
                      description: Le provider qui a renvoyé les données.
                      type: string
                    steps:
                      description: Chaque provider sollicité, dans l’ordre.
                      items:
                        properties:
                          creditsCost:
                            type: integer
                          provider:
                            type: string
                          status:
                            enum:
                              - matched
                              - not_found
                              - error
                            type: string
                        type: object
                      type: array
                  type: object
                sourceURL:
                  description: >-
                    L’URL initialement demandée. Elle peut différer de l’URL
                    finale de la page si des redirections ont été appliquées.
                  format: uri
                  type: string
                statusCode:
                  description: Le code de statut de la page
                  type: integer
                title:
                  description: >-
                    Titre extrait de la page, peut être une chaîne de caractères
                    ou un tableau de chaînes de caractères
                  oneOf:
                    - type: string
                    - items:
                        type: string
                      type: array
                totalPages:
                  description: >-
                    Pour les fichiers PDF, le nombre réel de pages du document
                    avant toute limitation par maxPages. Ce champ est omis
                    lorsqu’il ne peut pas être déterminé ; si totalPages est
                    supérieur à numPages, cela indique que le résultat a été
                    tronqué.
                  type: integer
                url:
                  description: >-
                    L’URL finale de la page après application de l’ensemble des
                    redirections.
                  format: uri
                  type: string
              type: object
            pages:
              description: >-
                Markdown physique de chaque page pour les PDF. Présent
                uniquement lorsque la requête a défini l’option `pages` du
                parseur PDF.
              items:
                properties:
                  markdown:
                    type: string
                  pageNumber:
                    description: Numéro de page PDF physique, indexé à partir de 1.
                    type: integer
                type: object
              nullable: true
              type: array
            product:
              description: >-
                Informations produit extraites de la page si `product` figure
                dans `formats`. Inclut le titre, la marque, la catégorie, la
                description et les variantes. La tarification, la disponibilité
                et les images se trouvent au niveau de chaque variante.
              nullable: true
              properties:
                brand:
                  description: La marque ou le fabricant du produit.
                  type: string
                category:
                  description: >-
                    La catégorie du produit, éventuellement sous forme de fil
                    d’Ariane (par ex. 'Électronique > Audio > Casques').
                  type: string
                description:
                  description: La description du produit.
                  type: string
                title:
                  description: Le titre du produit.
                  type: string
                url:
                  description: L’URL canonique de la page produit.
                  type: string
                variants:
                  description: >-
                    Variantes du produit (par ex. différentes couleurs ou
                    tailles).
                  items:
                    properties:
                      availability:
                        description: >-
                          La disponibilité de la variante. Toujours présente
                          pour une variante.
                        properties:
                          inStock:
                            description: Indique si la variante est en stock.
                            type: boolean
                          text:
                            description: >-
                              Texte de disponibilité lisible par l’humain (par
                              ex. 'En stock').
                            type: string
                        required:
                          - inStock
                        type: object
                      id:
                        description: L’identifiant de la variante.
                        type: string
                      images:
                        description: Images de la variante.
                        items:
                          properties:
                            alt:
                              description: Texte alternatif de l’image.
                              type: string
                            url:
                              description: URL de l’image.
                              type: string
                          required:
                            - url
                          type: object
                        type: array
                      price:
                        description: Le prix actuel de la variante.
                        properties:
                          amount:
                            description: Le montant numérique du prix.
                            type: number
                          currency:
                            description: Le code devise ISO 4217 (par ex. 'USD').
                            type: string
                          formatted:
                            description: >-
                              Le prix formaté pour l’affichage (par ex.
                              '$199.99').
                            type: string
                        required:
                          - amount
                        type: object
                      sale:
                        description: >-
                          Informations de vente/remise pour la variante,
                          présentes lorsque la variante bénéficie d’une remise.
                        properties:
                          originalPrice:
                            description: Le prix d’origine (avant remise) de la variante.
                            properties:
                              amount:
                                description: Le montant numérique du prix.
                                type: number
                              currency:
                                description: Le code devise ISO 4217 (par ex. 'USD').
                                type: string
                              formatted:
                                description: >-
                                  Le prix formaté pour l’affichage (par ex.
                                  '$249.99').
                                type: string
                            required:
                              - amount
                            type: object
                        required:
                          - originalPrice
                        type: object
                      sku:
                        description: Le SKU de la variante.
                        type: string
                      title:
                        description: Le titre de la variante.
                        type: string
                      values:
                        additionalProperties:
                          type: string
                        description: >-
                          Les valeurs d’option de la variante (par ex. {
                          "color": "Black" }).
                        type: object
                    required:
                      - availability
                    type: object
                  type: array
              required:
                - title
                - url
                - variants
              type: object
            rawBase64:
              description: >-
                Le corps de la réponse HTTP d’origine, encodé en Base64 si
                `rawBase64` est inclus dans `formats`. Une chaîne Base64 brute,
                et non un URI de données. Le type MIME se trouve dans
                `metadata.contentType`.
              nullable: true
              type: string
            rawHtml:
              description: >-
                Le code HTML brut, exactement tel qu’il est reçu depuis la page
                lorsque `rawHtml` est inclus dans `formats`. Aucun nettoyage ni
                filtrage n’est appliqué.
              nullable: true
              type: string
            screenshot:
              description: >-
                Capture d’écran de la page si `screenshot` est inclus dans
                `formats`. Les captures d’écran expirent au bout de 24 heures et
                ne peuvent ensuite plus être téléchargées.
              nullable: true
              type: string
            summary:
              description: Résumé de la page si `summary` est inclus dans `formats`
              nullable: true
              type: string
            tools:
              description: >-
                Contrats d’outils correspondant au domaine de la page scrapée.
                Présents uniquement lorsque `domainTools` est défini sur `true`
                dans la requête. Nécessite l’accès à Alexandria et que la
                conservation zéro des données ne soit pas activée (403 sinon) ;
                gratuit.
              items:
                $ref: '#/components/schemas/DiscoveredTool'
              nullable: true
              type: array
            video:
              description: >-
                URL signée du fichier vidéo extrait si `video` figure dans
                `formats`. L'URL signée expire au bout d'1 heure.
              nullable: true
              type: string
            warning:
              description: >-
                Peut être affiché lorsque vous utilisez l’extraction LLM. Un
                message d’avertissement vous indiquera tout problème lors de
                l’extraction.
              nullable: true
              type: string
          type: object
        success:
          type: boolean
      type: object
    AuditMetadata:
      additionalProperties: false
      description: >-
        Informations d’attribution de l’utilisateur incluses dans les événements
        de journalisation SIEM lorsque SIEM Logging est activé pour
        l’organisation.
      properties:
        username:
          description: Le nom d’utilisateur associé à la requête.
          maxLength: 1024
          type: string
      required:
        - username
      type: object
    ParseFormats:
      default:
        - markdown
      description: >-
        Formats de sortie pris en charge pour les téléversements `/parse`. Les
        formats avec rendu dans le Browser et le suivi des modifications ne sont
        pas pris en charge.
      items:
        oneOf:
          - properties:
              type:
                enum:
                  - markdown
                type: string
            required:
              - type
            title: Markdown
            type: object
          - properties:
              type:
                enum:
                  - summary
                type: string
            required:
              - type
            title: Summary
            type: object
          - properties:
              type:
                enum:
                  - html
                type: string
            required:
              - type
            title: HTML
            type: object
          - properties:
              type:
                enum:
                  - rawHtml
                type: string
            required:
              - type
            title: Raw HTML
            type: object
          - properties:
              type:
                enum:
                  - links
                type: string
            required:
              - type
            title: Links
            type: object
          - properties:
              type:
                enum:
                  - images
                type: string
            required:
              - type
            title: Images
            type: object
          - properties:
              prompt:
                description: Le prompt à utiliser pour la sortie JSON
                type: string
              schema:
                description: >-
                  Le schéma à utiliser pour la sortie JSON. Il doit être
                  conforme à [JSON Schema](https://json-schema.org/).
                type: object
              type:
                enum:
                  - json
                type: string
            required:
              - type
            title: JSON
            type: object
      type: array
    RedactPIIOptions:
      additionalProperties: false
      description: Options de réglage du masquage des PII.
      properties:
        entities:
          description: >-
            Limitez le masquage à ces groupes d'entités. Si ce champ est omis,
            toutes les entités prises en charge sont masquées.
          items:
            $ref: '#/components/schemas/RedactPIIEntity'
          type: array
        mode:
          default: accurate
          description: >-
            Stratégie de masquage. `accurate` utilise uniquement le modèle et
            est optimisée pour la précision, `aggressive` augmente le rappel
            grâce à des heuristiques supplémentaires, et `fast` utilise des
            heuristiques sans appel au modèle.
          enum:
            - accurate
            - aggressive
            - fast
          type: string
        replaceStyle:
          default: tag
          description: >-
            `tag` remplace les portions de texte par des marqueurs comme
            `<EMAIL>`, `mask` remplace les caractères par `*`, et `remove`
            supprime le texte de la portion.
          enum:
            - tag
            - mask
            - remove
          type: string
      type: object
    DiscoveredTool:
      additionalProperties: true
      description: "Un outil de fournisseur catalogué découvert via Alexandria, la recherche sémantique ou la correspondance de domaine. Le paramètre de requête `toolDetail` détermine les champs renvoyés\_: `compact` renvoie uniquement `provider`, `capability` et `description`\_; `summary` ajoute les autres champs sauf `options` et `response`\_; `full` ajoute également `options`, `response` et `examples`."
      properties:
        capability:
          description: La fonctionnalité propre au fournisseur.
          type: string
        creditsCost:
          description: >-
            Crédits facturés à chaque exécution de cet outil. Omis lorsque
            `toolDetail` vaut `compact`.
          minimum: 0
          type: integer
        description:
          description: Description lisible par l’utilisateur de la fonction de l’outil.
          type: string
        id:
          description: >-
            L’identifiant de l’outil, au format `provider/capability`. Omis
            lorsque `toolDetail` vaut `compact`.
          type: string
        matchedBy:
          description: >-
            Raison pour laquelle cet outil a été proposé. Omis lorsque
            `toolDetail` vaut `compact`.
          items:
            enum:
              - semantic
              - domain
            type: string
          type: array
        matchedUrls:
          description: >-
            URL dont le domaine correspond à cet outil, en cas de correspondance
            par domaine. Omis lorsque `toolDetail` vaut `compact`.
          items:
            type: string
          type: array
        name:
          description: >-
            Nom de l’outil lisible par l’utilisateur. Omis lorsque `toolDetail`
            vaut `compact`.
          type: string
        options:
          description: >-
            Les options acceptées par la fonctionnalité. Présentes uniquement
            lorsque `toolDetail` vaut `full`.
          items:
            additionalProperties: true
            properties:
              name:
                description: Le nom de l’option.
                type: string
              type:
                description: Le type de données de l’option.
                type: string
            type: object
          type: array
        perRecord:
          description: >-
            Indique si `creditsCost` est facturé par enregistrement renvoyé
            plutôt que par appel. Omis lorsque `toolDetail` vaut `compact`.
          type: boolean
        provider:
          description: Le fournisseur catalogué.
          type: string
        response:
          additionalProperties: true
          description: >-
            Description de la structure du champ `data` d’une réponse réussie.
            Présente uniquement lorsque `toolDetail` vaut `full`.
          properties:
            about:
              description: >-
                Description lisible par l’utilisateur de la charge utile de la
                réponse.
              type: string
            fields:
              description: Les champs documentés de la réponse.
              items:
                additionalProperties: true
                type: object
              type: array
            key:
              description: >-
                La clé sous laquelle la charge utile principale est renvoyée, le
                cas échéant.
              type: string
          type: object
      required:
        - provider
        - capability
        - description
      type: object
    RedactPIIEntity:
      description: >-
        Groupes d'entités PII publiques pris en charge par le masquage de
        Firecrawl.
      enum:
        - PERSON
        - EMAIL
        - PHONE
        - LOCATION
        - FINANCIAL
        - SECRET
      type: string
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.