# Obtenir l’état d’une extraction par lot (/fr/api-reference/endpoint/batch-scrape-get)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 2682 · updated: 2026-07-30 -->
Related: [Recherche](/fr/api-reference/endpoint/search.md), [Retour sur la recherche](/fr/api-reference/endpoint/search-feedback.md), [Scrape](/fr/api-reference/endpoint/scrape.md), [Scrape par lot](/fr/api-reference/endpoint/batch-scrape.md), [Annuler une extraction par lots](/fr/api-reference/endpoint/batch-scrape-delete.md), [Récupérer les erreurs d'extraction par lot](/fr/api-reference/endpoint/batch-scrape-get-errors.md)

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

`GET /batch/scrape/{id}`

Obtenir l'état d'un job de scraping par lots

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "description": "L’ID de la tâche de scraping par lots",
      "in": "path",
      "name": "id",
      "required": true,
      "schema": {
        "format": "uuid",
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "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": {
                    "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"
                    },
                    "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"
          }
        }
      },
      "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"
    }
  }
}
```
