Descripción general

Notificaciones en tiempo real para tus operaciones de Firecrawl

Los webhooks te permiten recibir notificaciones en tiempo real a medida que avanzan tus operaciones, en lugar de consultar periódicamente su estado.

​

Operaciones admitidas

Operación	Eventos
Crawl	started, page, completed
Batch Scrape	started, page, completed
Extract	started, completed, failed
Agent	started, action, completed, failed, cancelled

​

Configuración

Añade un objeto webhook a tu solicitud:

JSON

{
  "webhook": {
    "url": "https://your-domain.com/webhook",
    "metadata": {
      "any_key": "any_value"
    },
    "events": ["iniciado", "página", "completado", "error"]
  }
}

Campo	Tipo	Requerido	Descripción
url	string	Sí	La URL de tu endpoint (HTTPS)
headers	object	No	Encabezados personalizados para incluir en las solicitudes del webhook
metadata	object	No	Datos personalizados incluidos en las cargas del webhook
events	array	No	Tipos de eventos a recibir (por defecto: todos los eventos)

​

Uso

​

Rastreo con webhook

cURL

curl -X POST https://api.firecrawl.dev/v2/crawl \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d '{
      "url": "https://docs.firecrawl.dev",
      "limit": 100,
      "webhook": {
        "url": "https://tu-dominio.com/webhook",
        "metadata": {
          "any_key": "any_value"
        },
        "events": ["started", "page", "completed"]
      }
    }'

​

Raspado en lote con webhook

cURL

curl -X POST https://api.firecrawl.dev/v2/batch/scrape \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d '{
      "urls": [
        "https://example.com/page1",
        "https://example.com/page2",
        "https://example.com/page3"
      ],
      "webhook": {
        "url": "https://your-domain.com/webhook",
        "metadata": {
          "any_key": "any_value"
        },
        "events": ["started", "page", "completed"]
      }
    }'

​

Tiempos de espera y reintentos

Tu endpoint debe responder con un estado 2xx en un plazo de 10 segundos.

Si la entrega falla (se excede el tiempo de espera, el estado no es 2xx o hay un error de red), Firecrawl reintenta automáticamente:

Reintento	Retraso después del fallo
1.º	1 minuto
2.º	5 minutos
3.º	15 minutos

Después de 3 reintentos fallidos, el webhook se marca como fallido y no se realizan más intentos.