Saltar al contenido principal
Los webhooks te permiten recibir notificaciones en tiempo real sobre tus operaciones de Firecrawl conforme progresan, en lugar de consultar periódicamente el estado.

​
Operaciones admitidas

OperaciónEventos
Crawlstarted, page, completed
Batch Scrapestarted, page, completed
Extractstarted, completed, failed

​
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"]
  }
}
CampoTipoRequeridoDescripción
urlstringSíLa URL de tu endpoint (HTTPS)
headersobjectNoEncabezados personalizados para incluir en las solicitudes del webhook
metadataobjectNoDatos personalizados incluidos en las cargas del webhook
eventsarrayNoTipos 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:
ReintentoRetraso 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.