Introducción - Firecrawl Docs

Note

Para agentes de IA: Usa llms.txt para obtener un índice completo de toda la documentación.

La API de Firecrawl proporciona acceso programático a datos de la web. Todos los endpoints comparten la misma URL base, el mismo esquema de autenticación y el formato de respuesta descritos en esta página.

Funcionalidades#

Busca en la web y obtén el contenido completo de la página en cualquier formato.

Scrape

Extrae contenido de cualquier página web en formato markdown o JSON.

Interact

Crea una sesión de Interact para hacer clic, rellenar formularios y navegar por páginas.

Parse

Sube archivos y procésalos en markdown u otros formatos.

Monitor

Programa verificaciones recurrentes y recibe notificaciones cuando cambie el contenido.

Crawl

Rastrea sitios web completos y obtén el contenido de todas sus páginas.

Map

Obtén un listado completo de URLs de cualquier sitio web de forma rápida y confiable.

Agent

Recopilación autónoma de datos web impulsada por IA.

URL base#

Todas las solicitudes utilizan la siguiente URL base:

https://api.firecrawl.dev

Autenticación#

Todas las solicitudes deben incluir un encabezado Authorization con tu clave de API:

Authorization: Bearer fc-YOUR-API-KEY

Incluye este encabezado en todas las llamadas a la API. Puedes encontrar tu clave de API en el dashboard de Firecrawl.

Si eres un agente sin una clave de API, comienza con Obtener credenciales. Si tu plataforma es compatible con WorkOS ID-JAG, usa auth.md para ver las instrucciones de registro.

curl -X POST "https://api.firecrawl.dev/v2/scrape" \  -H "Authorization: Bearer fc-YOUR-API-KEY" \  -H "Content-Type: application/json" \  -d '{"url": "https://example.com"}'

Códigos de respuesta#

Firecrawl utiliza códigos de estado HTTP convencionales para indicar el resultado de tus solicitudes. Los códigos en el rango 2xx indican éxito, los códigos 4xx indican errores del cliente y los códigos 5xx indican errores del servidor.

Consulta Errores para obtener la referencia completa, incluida la cadena error que se devuelve para cada tipo de fallo, la guía de reintentos y un fragmento de backoff listo para copiar y pegar.

Respuestas 429#

Cuando superas los límites de tasa o de concurrencia de tu plan, la API devuelve un código de estado 429. Consulta Rate Limits para ver los límites por plan y Errores para obtener orientación sobre los reintentos.