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

# Obtenir l’état d’une extraction par lot

> Êtes-vous un agent d’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 GET /batch/scrape/{id}
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:
  /batch/scrape/{id}:
    parameters:
      - description: L’ID de la tâche de scraping par lots
        in: path
        name: id
        required: true
        schema:
          format: uuid
          type: string
    get:
      tags:
        - Scraping
      summary: Obtenir l'état d'un job de scraping par lots
      operationId: getBatchScrapeStatus
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchScrapeStatusResponseObj'
          description: Réponse en cas de succès
        '402':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Payment required to access this resource.
                    type: string
                type: object
          description: Paiement requis
        '429':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
                    type: string
                type: object
          description: Trop de requêtes
        '500':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: An unexpected error occurred on the server.
                    type: string
                type: object
          description: Erreur du serveur
      security:
        - bearerAuth: []
components:
  schemas:
    BatchScrapeStatusResponseObj:
      properties:
        completed:
          description: Le nombre de pages récupérées avec succès.
          type: integer
        completedAt:
          description: >-
            La date et l’heure auxquelles l’extraction par lot s’est terminée.
            Présent uniquement lorsque l’extraction par lot est dans un état
            terminal (`completed`, `failed` ou `cancelled`).
          format: date-time
          type: string
        createdAt:
          description: La date et l’heure auxquelles l’extraction par lot a démarré.
          format: date-time
          type: string
        creditsUsed:
          description: Nombre de crédits utilisés pour le scraping en lot.
          type: integer
        data:
          description: Les données de l'extraction par lots.
          items:
            properties:
              blocks:
                description: >-
                  Blocs de mise en page typés de chaque page pour les PDF.
                  Présents uniquement lorsque la requête définit 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és entre 0 et 1 par
                              rapport à la largeur et à la hauteur de la page.
                              Multipliez par la largeur et la 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 n'a pas fait
                                  l'objet d'une 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 que ce bloc a ajouté 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
              html:
                description: Version HTML du contenu de la page si `includeHtml` vaut true
                nullable: true
                type: string
              links:
                description: >-
                  Liste des liens présents sur la page si `includeLinks` est
                  vrai
                items:
                  type: string
                type: array
              markdown:
                type: string
              metadata:
                properties:
                  '<any other metadata> ':
                    type: string
                  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
                  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 de chaîne ou de
                      tableau de chaînes
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  language:
                    description: >-
                      Langue extraite de la page, peut être une chaîne de
                      caractères 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: Paramètres régionaux alternatifs de la page
                    items:
                      type: string
                    type: array
                  sourceURL:
                    description: >-
                      L’URL initiale demandée. Elle peut différer de l’URL
                      finale de la page si des redirections ont eu lieu.
                    format: uri
                    type: string
                  statusCode:
                    description: Le code d’état HTTP de la page
                    type: integer
                  title:
                    description: >-
                      Titre extrait de la page, peut être une chaîne 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 toutes les
                      redirections.
                    format: uri
                    type: string
                type: object
              pages:
                description: >-
                  Markdown physique de chaque page pour les PDF. Présent
                  uniquement lorsque la requête définit 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
              rawHtml:
                description: Contenu HTML brut de la page si `includeRawHtml` vaut true
                nullable: true
                type: string
              screenshot:
                description: Capture d’écran de la page si `includeScreenshot` vaut true
                nullable: true
                type: string
            type: object
          type: array
        duration:
          description: >-
            Durée de l’extraction par lot en secondes. Pour les extractions par
            lot terminées, il s’agit du temps écoulé entre `createdAt` et
            `completedAt`. Pour les extractions par lot en cours, il s’agit du
            temps écoulé entre `createdAt` et maintenant.
          type: number
        expiresAt:
          description: La date et l’heure d’expiration du lot de scraping.
          format: date-time
          type: string
        next:
          description: >-
            L’URL permettant de récupérer les 10 Mo de données suivants.
            Renvoyée si le scraping par lots n’est pas terminé ou si la réponse
            dépasse 10 Mo.
          nullable: true
          type: string
        status:
          description: >-
            État actuel du scraping par lot. Peut être `scraping`, `completed`
            ou `failed`.
          type: string
        total:
          description: Nombre total de pages pour lesquelles un scraping a été tenté.
          type: integer
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````