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

# Scrape

<div id="interactions">
  ## Interactions
</div>

Pour les interactions avec le navigateur (clic, saisie, navigation, extraction de contenu dynamique), utilisez le [point de terminaison Interact](/fr/features/interact). Effectuez d’abord le scrape d’une page, puis appelez `POST /v2/scrape/{scrapeId}/interact` avec un prompt en langage naturel ou du code Playwright pour effectuer des actions sur la page.

Consultez la [documentation Interact](/fr/features/interact) pour tous les détails et des exemples.

Vous pouvez aussi utiliser le paramètre `actions`, mais son usage n’est pas recommandé pour des interactions complexes.

> Êtes-vous un agent IA ayant besoin d’une clé API Firecrawl ? Consultez [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) pour obtenir des instructions d’intégration automatisée.


## OpenAPI

````yaml fr/api-reference/v2-openapi.json POST /scrape
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:
  /scrape:
    post:
      tags:
        - Scraping
      summary: >-
        Récupérer le contenu d’une URL et éventuellement en extraire des
        informations à l’aide d’un LLM
      operationId: scrapeAndExtractFromUrl
      requestBody:
        content:
          application/json:
            schema:
              allOf:
                - properties:
                    url:
                      description: L’URL à scraper
                      format: uri
                      type: string
                  required:
                    - url
                  type: object
                - $ref: '#/components/schemas/ScrapeOptions'
                - properties:
                    zeroDataRetention:
                      default: false
                      description: >-
                        Si la valeur est true, cela activera la non-conservation
                        totale des données pour ce scraping. Pour activer cette
                        fonctionnalité, veuillez contacter help@firecrawl.dev
                      type: boolean
                  type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScrapeResponse'
          description: Réponse réussie
        '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 du serveur
      security:
        - bearerAuth: []
components:
  schemas:
    ScrapeOptions:
      properties:
        actions:
          description: Actions à effectuer sur la page avant de récupérer le contenu
          items:
            oneOf:
              - oneOf:
                  - additionalProperties: false
                    properties:
                      milliseconds:
                        description: Nombre de millisecondes à attendre
                        minimum: 1
                        type: integer
                      type:
                        description: Attendre un nombre spécifié de millisecondes
                        enum:
                          - wait
                        type: string
                    required:
                      - type
                      - milliseconds
                    title: Wait by Duration
                    type: object
                  - additionalProperties: false
                    properties:
                      selector:
                        description: Sélecteur CSS à surveiller
                        example: '#my-element'
                        type: string
                      type:
                        description: Attendre l’apparition d’un élément spécifique
                        enum:
                          - wait
                        type: string
                    required:
                      - type
                      - selector
                    title: Wait for Element
                    type: object
                title: Wait
              - properties:
                  fullPage:
                    default: false
                    description: >-
                      Indique s’il faut prendre une capture d’écran de la page
                      entière (en ignorant viewport.height) ou seulement de la
                      zone actuellement visible (viewport).
                    type: boolean
                  quality:
                    description: >-
                      Qualité de la capture d’écran, de 1 à 100, 100 étant la
                      meilleure qualité.
                    type: integer
                  type:
                    description: >-
                      Prenez une capture d’écran. Les liens se trouveront dans
                      le tableau `actions.screenshots` de la réponse.
                    enum:
                      - screenshot
                    type: string
                  viewport:
                    properties:
                      height:
                        description: Hauteur du viewport en pixels
                        type: integer
                      width:
                        description: La largeur de la fenêtre d’affichage, en pixels
                        type: integer
                    required:
                      - width
                      - height
                    type: object
                required:
                  - type
                title: Screenshot
                type: object
              - properties:
                  all:
                    default: false
                    description: >-
                      Clique sur tous les éléments correspondant au sélecteur,
                      et pas seulement sur le premier. Ne lève pas d’erreur si
                      aucun élément ne correspond au sélecteur.
                    type: boolean
                  selector:
                    description: Sélecteur pour trouver l’élément par
                    example: '#load-more-button'
                    type: string
                  type:
                    description: Cliquez sur un élément
                    enum:
                      - click
                    type: string
                required:
                  - type
                  - selector
                title: Click
                type: object
              - properties:
                  text:
                    description: Texte à saisir
                    example: Hello, world!
                    type: string
                  type:
                    description: >-
                      Écrivez du texte dans un champ de saisie, une zone de
                      texte ou un élément contenteditable. Remarque : vous devez
                      d’abord placer le focus sur l’élément à l’aide d’une
                      action « click » avant d’écrire. Le texte sera saisi
                      caractère par caractère pour simuler une saisie au
                      clavier.
                    enum:
                      - write
                    type: string
                required:
                  - type
                  - text
                title: Write text
                type: object
              - description: >-
                  Appuyez sur une touche du clavier. Reportez-vous à
                  https://asawicki.info/nosense/doc/devices/keyboard/key_codes.html
                  pour la liste des codes de touches.
                properties:
                  key:
                    description: Touche sur laquelle appuyer
                    example: Enter
                    type: string
                  type:
                    description: Appuyez sur une touche de la page
                    enum:
                      - press
                    type: string
                required:
                  - type
                  - key
                title: Press a key
                type: object
              - properties:
                  direction:
                    default: down
                    description: Sens de défilement
                    enum:
                      - up
                      - down
                    type: string
                  selector:
                    description: Sélecteur CSS de l’élément à faire défiler
                    example: '#my-element'
                    type: string
                  type:
                    description: Faites défiler la page ou un élément spécifique
                    enum:
                      - scroll
                    type: string
                required:
                  - type
                title: Scroll
                type: object
              - properties:
                  type:
                    description: >-
                      Extrait le contenu de la page actuelle et renvoie l’URL et
                      le HTML.
                    enum:
                      - scrape
                    type: string
                required:
                  - type
                title: Scrape
                type: object
              - properties:
                  script:
                    description: Code JavaScript à exécuter
                    example: document.querySelector('.button').click();
                    type: string
                  type:
                    description: Exécuter du code JavaScript sur la page
                    enum:
                      - executeJavascript
                    type: string
                required:
                  - type
                  - script
                title: Execute JavaScript
                type: object
              - properties:
                  format:
                    default: Letter
                    description: Le format de page du PDF obtenu
                    enum:
                      - A0
                      - A1
                      - A2
                      - A3
                      - A4
                      - A5
                      - A6
                      - Letter
                      - Legal
                      - Tabloid
                      - Ledger
                    type: string
                  landscape:
                    default: false
                    description: Détermine s’il faut générer le PDF au format paysage
                    type: boolean
                  scale:
                    default: 1
                    description: Facteur d’échelle du PDF généré
                    type: number
                  type:
                    description: >-
                      Génère un PDF de la page en cours. Le PDF sera renvoyé
                      dans le tableau `actions.pdfs` de la réponse.
                    enum:
                      - pdf
                    type: string
                required:
                  - type
                title: Generate PDF
                type: object
          type: array
        blockAds:
          default: true
          description: >-
            Active le blocage des publicités et des fenêtres contextuelles de
            cookies.
          type: boolean
        excludeTags:
          description: Balises à exclure du résultat.
          items:
            type: string
          type: array
        formats:
          $ref: '#/components/schemas/Formats'
        headers:
          description: >-
            En-têtes à inclure dans la requête. Peuvent être utilisés pour
            envoyer des cookies, un user-agent, etc.
          type: object
        includeTags:
          description: Balises à inclure dans le résultat.
          items:
            type: string
          type: array
        location:
          description: >-
            Paramètres de localisation pour la requête. Lorsqu’ils sont définis,
            un proxy approprié sera utilisé si disponible et les paramètres de
            langue et de fuseau horaire correspondants seront simulés. La valeur
            par défaut est « US » si aucun n’est spécifié.
          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é. Utilise par défaut la langue de l’emplacement
                spécifié. Voir
                https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
              items:
                example: en-US
                type: string
              type: array
          type: object
        lockdown:
          default: false
          description: >-
            Si défini sur true, la requête est traitée uniquement à partir du
            cache de Firecrawl et n’effectue jamais de requête sortante vers
            l’URL cible. Conçu pour les environnements soumis à des contraintes
            de conformité ou isolés du réseau, où la requête de scrape elle-même
            pourrait divulguer des informations sensibles. En cas d’absence dans
            le cache, renvoie une 404 avec le code d’erreur
            SCRAPE_LOCKDOWN_CACHE_MISS (l’URL n’est jamais journalisée en cas
            d’absence dans le cache). Les requêtes Lockdown sont traitées en
            mode zero data retention. La valeur maxAge par défaut est portée à 2
            ans afin que les pages déjà mises en cache restent éligibles.
            Facturé 5 crédits en cas de hit, 1 crédit en cas d’absence dans le
            cache.
          type: boolean
        maxAge:
          default: 172800000
          description: "Retourne une version mise en cache de la page si elle est plus récente que cette durée (en millisecondes). Si une version mise en cache de la page est plus ancienne que cette valeur, la page sera à nouveau explorée (scrapée). Si vous n’avez pas besoin de données extrêmement récentes, activer cette option peut accélérer vos opérations de scraping de 500 %. Par défaut\_: 2\_jours."
          type: integer
        minAge:
          description: >-
            Lorsqu’elle est définie, la requête vérifie uniquement le cache et
            ne déclenche jamais une nouvelle opération de scraping. La valeur
            est exprimée en millisecondes et indique l’âge minimal que doivent
            avoir les données en cache. Si des données en cache correspondantes
            existent, elles sont renvoyées instantanément. Si aucune donnée en
            cache n’est trouvée, une réponse 404 avec le code d’erreur
            SCRAPE_NO_CACHED_DATA est renvoyée. Définissez-la sur 1 pour
            accepter n’importe quelle donnée en cache, quel que soit son âge.
          type: integer
        mobile:
          default: false
          description: >-
            Définissez cette option sur true pour simuler le scraping depuis un
            appareil mobile. Utile pour tester des pages responsives et prendre
            des captures d’écran en mode mobile.
          type: boolean
        onlyCleanContent:
          default: false
          description: >-
            Bêta. Exécute un passage supplémentaire basé sur un LLM sur le
            markdown généré afin de supprimer les éléments parasites résiduels
            que `onlyMainContent` peut manquer (bannières de cookies, blocs
            publicitaires, widgets de partage sur les réseaux sociaux, fils
            d’Ariane, inscriptions à la newsletter, sections de commentaires,
            listes d’articles similaires). Les titres, listes, tableaux, blocs
            de code, références d’images et liens intégrés sont conservés. Peut
            être combiné avec `onlyMainContent` (la configuration la plus
            courante) ou utilisé seul. Ignoré avec un avertissement lorsque le
            markdown dépasse la limite de jetons de sortie du modèle de
            nettoyage (le markdown d’origine est conservé). Non pris en charge
            pour les requêtes sans conservation des données.
          type: boolean
        onlyMainContent:
          default: true
          description: >-
            Retourne uniquement le contenu principal de la page, à l’exclusion
            des en-têtes, menus de navigation, pieds de page, etc. Il s’agit
            d’un filtre déterministe appliqué au niveau HTML avant la génération
            du markdown ; aucun LLM n’intervient.
          type: boolean
        parsers:
          default:
            - pdf
          description: >-
            Contrôle la façon dont les fichiers sont traités lors du scraping.
            Lorsque « pdf » est inclus (valeur par défaut), le contenu du PDF
            est extrait et converti au format Markdown, avec une facturation
            basée sur le nombre de pages (1 crédit par page). Lorsqu’un tableau
            vide est envoyé, le fichier PDF est renvoyé en encodage base64 avec
            un tarif fixe de 1 crédit pour l’ensemble du PDF.
          items:
            oneOf:
              - additionalProperties: false
                properties:
                  maxPages:
                    description: >-
                      Nombre maximal de pages du PDF à analyser. Doit être un
                      entier positif inférieur ou égal à 10 000.
                    maximum: 10000
                    minimum: 1
                    type: integer
                  mode:
                    default: auto
                    description: >-
                      Mode d’analyse des PDF. « fast » : extraction basée
                      uniquement sur le texte (texte intégré, la plus rapide). «
                      auto » (par défaut) : tente d’abord une extraction rapide,
                      puis bascule vers l’OCR si nécessaire. « ocr » : impose
                      une analyse OCR (reconnaissance optique de caractères) sur
                      chaque page.
                    enum:
                      - fast
                      - auto
                      - ocr
                    type: string
                  type:
                    enum:
                      - pdf
                    type: string
                required:
                  - type
                type: object
          type: array
        profile:
          description: >-
            Active le stockage persistant du navigateur entre les sessions de
            scrape et d’Interact. Transmettez un profil lors du scraping pour
            conserver les cookies, le localStorage et les données de session.
            Les sessions portant le même nom de profil partagent l’état du
            navigateur.
          properties:
            name:
              description: >-
                Nom du profil. Les scrapes portant le même nom partagent l’état
                du navigateur (cookies, localStorage, sessions).
              maxLength: 128
              minLength: 1
              type: string
            saveChanges:
              default: true
              description: >-
                Si la valeur est true, l’état du navigateur est enregistré dans
                le profil lorsque la session Interact s’arrête. Définissez la
                valeur sur false pour charger les données existantes sans les
                écrire. Une seule session d’enregistrement est autorisée à la
                fois.
              type: boolean
          required:
            - name
          type: object
        proxy:
          default: auto
          description: "Spécifie le type de proxy à utiliser.\n\n - **basic**\_: Proxies pour le scraping de sites avec des solutions anti‑bots inexistantes ou basiques. Rapides et généralement efficaces.\n - **enhanced**\_: Proxies renforcés pour le scraping de sites avec des solutions anti‑bots avancées. Plus lents, mais plus fiables sur certains sites. Peut coûter jusqu’à 5 crédits par requête.\n - **auto**\_: Firecrawl réessaiera automatiquement le scraping avec des proxies renforcés si le proxy basic échoue. Si la nouvelle tentative avec le proxy renforcé réussit, 5 crédits seront facturés pour l’opération de scraping. Si la première tentative avec le proxy basic réussit, seul le coût standard sera facturé."
          enum:
            - basic
            - enhanced
            - 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: |-
            <[
              {
                "key": "0",
                "translation": "Supprime toutes les images encodées en base64 de la sortie markdown, qui peut devenir excessivement longue. Cela n’affecte pas les formats html ou rawHtml. Le texte alternatif de l’image reste dans la sortie, mais l’URL est remplacée par un espace réservé."
              }
            ]</>
          type: boolean
        skipTlsVerification:
          default: true
          description: Ignorer la vérification du certificat TLS lors des requêtes.
          type: boolean
        storeInCache:
          default: true
          description: >-
            Si ce paramètre est défini sur true, la page sera stockée dans
            l’index et le cache de Firecrawl. Le définir sur false est utile si
            votre activité de scraping peut soulever des problèmes de protection
            des données. L’utilisation de certains paramètres associés à un
            scraping sensible (par ex. actions, headers) forcera ce paramètre à
            false.
          type: boolean
        threatProtection:
          $ref: '#/components/schemas/ThreatProtectionOverride'
        timeout:
          default: 60000
          description: >-
            Délai d’expiration de la requête en millisecondes. La valeur
            minimale est de 1000 (1 seconde). La valeur par défaut est de 60000
            (60 secondes). La valeur maximale est de 300000 (300 secondes).
          maximum: 300000
          minimum: 1000
          type: integer
        waitFor:
          default: 0
          description: >-
            Indiquez un délai en millisecondes avant de récupérer le contenu,
            afin de laisser à la page suffisamment de temps pour se charger. Ce
            temps d’attente s’ajoute à la fonction d’attente intelligente de
            Firecrawl.
          type: integer
      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
            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
                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
            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
            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
            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
    Formats:
      default:
        - markdown
      description: >-
        Formats de sortie à inclure dans la réponse. Vous pouvez spécifier un ou
        plusieurs formats, soit sous forme de chaînes (par ex. `'markdown'`),
        soit sous forme d’objets avec des options supplémentaires (par ex. `{
        type: 'json', schema: {...} }`). Certains formats requièrent la
        définition d’options spécifiques. Exemple : `['markdown', { type:
        'json', schema: {...} }]`.
      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:
              fullPage:
                default: false
                description: >-
                  Indique s’il faut prendre une capture d’écran de la page
                  entière (en ignorant viewport.height) ou seulement de la zone
                  actuellement visible (viewport).
                type: boolean
              quality:
                description: >-
                  La qualité de la capture d’écran, sur une échelle de 1 à 100.
                  100 correspond à la qualité maximale.
                type: integer
              type:
                enum:
                  - screenshot
                type: string
              viewport:
                properties:
                  height:
                    description: La hauteur du viewport en pixels
                    type: integer
                  width:
                    description: Largeur du viewport en pixels
                    type: integer
                required:
                  - width
                  - height
                type: object
            required:
              - type
            title: Screenshot
            type: object
          - properties:
              prompt:
                description: L’invite à utiliser pour la sortie au format JSON
                type: string
              schema:
                description: >-
                  Le schéma à utiliser pour la sortie JSON. Doit être conforme à
                  [JSON Schema](https://json-schema.org/).
                type: object
              type:
                enum:
                  - json
                type: string
            required:
              - type
            title: JSON
            type: object
          - properties:
              modes:
                description: >-
                  Le mode de suivi des modifications à utiliser. « git-diff »
                  fournit un diff détaillé, tandis que « json » compare les
                  données JSON extraites.
                items:
                  enum:
                    - git-diff
                    - json
                  type: string
                type: array
              prompt:
                description: >-
                  Invite (prompt) à utiliser pour le suivi des modifications en
                  mode « json ». S’il n’est pas fourni, l’invite (prompt) par
                  défaut sera utilisée.
                type: string
              schema:
                description: >-
                  Schéma JSON pour l’extraction en mode « json ». Définit la
                  structure des données à extraire et à comparer. Doit être
                  conforme à [JSON Schema](https://json-schema.org/).
                type: object
              tag:
                default: null
                description: >-
                  Tag à utiliser pour le suivi des modifications. Les tags
                  peuvent séparer l’historique du suivi des modifications en «
                  branches » distinctes, où le suivi avec un tag spécifique ne
                  sera comparé qu’aux extractions effectuées avec ce même tag.
                  S’il n’est pas fourni, le tag par défaut (null) sera utilisé.
                nullable: true
                type: string
              type:
                enum:
                  - changeTracking
                type: string
            required:
              - type
            title: Change Tracking
            type: object
          - properties:
              type:
                enum:
                  - branding
                type: string
            required:
              - type
            title: Branding
            type: object
          - properties:
              type:
                enum:
                  - product
                type: string
            required:
              - type
            title: Product
            type: object
          - properties:
              type:
                enum:
                  - menu
                type: string
            required:
              - type
            title: Menu
            type: object
          - description: >-
              Extrait l’audio (MP3) depuis des URL vidéo prises en charge, par
              ex. YouTube. Renvoie une URL GCS signée.
            properties:
              type:
                enum:
                  - audio
                type: string
            required:
              - type
            title: Audio
            type: object
          - description: >-
              Extrait la vidéo dans la meilleure qualité depuis des URL vidéo
              prises en charge, par ex. YouTube. Renvoie une URL GCS signée.
            properties:
              type:
                enum:
                  - video
                type: string
            required:
              - type
            title: Video
            type: object
          - description: >-
              Pose une question en langage naturel sur la page. Renvoie la
              réponse dans le champ `answer` de la réponse.
            properties:
              question:
                description: >-
                  La question à laquelle répondre sur la page. Maximum 10 000
                  caractères.
                maxLength: 10000
                type: string
              type:
                enum:
                  - question
                type: string
            required:
              - type
              - question
            title: Question
            type: object
          - description: >-
              Trouve le texte source pertinent sur la page. Renvoie le texte
              sélectionné dans le champ `highlights` de la réponse.
            properties:
              query:
                description: >-
                  La requête de sélection de texte à exécuter sur la page.
                  Maximum 10 000 caractères.
                maxLength: 10000
                type: string
              type:
                enum:
                  - highlights
                type: string
            required:
              - type
              - query
            title: Highlights
            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
    ThreatProtectionOverride:
      description: >-
        Dérogation [Protection contre les
        menaces](https://docs.firecrawl.dev/features/threat-protection) au
        niveau de la requête. 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 qui inclut cet objet est
        rejetée avec un code 403. Si la Protection contre les menaces est
        appliquée à 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 motifs avec joker (`*.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 classifieur est injoignable :
            `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 analysée).
          enum:
            - 'off'
            - normal
          type: string
        riskScoreThreshold:
          description: >-
            Score de risque normalisé (0–100) à partir duquel une décision du
            classifieur bloque l’URL. Plus il est faible, plus le filtrage est
            strict.
          example: 75
          maximum: 100
          minimum: 0
          type: integer
        whitelist:
          description: >-
            Domaines à toujours autoriser, sous forme de domaines simples ou de
            motifs avec joker. Prend le pas sur toutes les autres règles.
          items:
            type: string
          maxItems: 1000
          type: array
      title: Threat Protection Override
      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

````