# Début du scraping par lot (/fr/api-reference/endpoint/webhook-batch-scrape-started)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 666 · 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), [Obtenir l’état d’une extraction par lot](/fr/api-reference/endpoint/batch-scrape-get.md), [Annuler une extraction par lots](/fr/api-reference/endpoint/batch-scrape-delete.md)

Pour des exemples de payload, la configuration et le comportement des nouvelles tentatives, consultez [Webhook Event Types](/fr/webhooks/events#batch_scrapestarted) et [Webhook Overview](/fr/webhooks/overview).

`POST` webhook `batchScrapeStarted`

Extraction par lot commencée

## OpenAPI

```json
{
  "parameters": [
    {
      "description": "Signature HMAC-SHA256 du corps brut de la requête, au format `sha256=<hex>`. Présente lorsqu’un secret HMAC est configuré dans les [paramètres de votre compte](https://www.firecrawl.dev/app/settings?tab=advanced). Consultez [Sécurité des webhooks](/webhooks/security) pour savoir comment la vérifier.",
      "in": "header",
      "name": "X-Firecrawl-Signature",
      "required": false,
      "schema": {
        "example": "sha256=abc123def456789...",
        "type": "string"
      }
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "example": {
          "data": [],
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "metadata": {},
          "success": true,
          "type": "batch_scrape.started",
          "webhookId": "b2c3d4e5-0001-0000-0000-000000000000"
        },
        "schema": {
          "properties": {
            "data": {
              "default": [],
              "items": {},
              "type": "array"
            },
            "id": {
              "description": "L’ID de la tâche d’extraction par lot, correspondant à l’`id` renvoyé par `POST /batch/scrape`.",
              "format": "uuid",
              "type": "string"
            },
            "metadata": {
              "additionalProperties": {
                "type": "string"
              },
              "description": "L’objet de métadonnées personnalisé que vous avez fourni dans la configuration du webhook. Renvoyé dans chaque envoi de webhook.",
              "type": "object"
            },
            "success": {
              "const": true,
              "type": "boolean"
            },
            "type": {
              "const": "batch_scrape.started",
              "type": "string"
            },
            "webhookId": {
              "description": "Identifiant unique de cet envoi de webhook.",
              "format": "uuid",
              "type": "string"
            }
          },
          "required": [
            "success",
            "type",
            "id",
            "webhookId",
            "data"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "Renvoyez n’importe quel code d’état `2xx` pour en accuser réception."
    }
  }
}
```