Documentation Index
Fetch the complete documentation index at: https://firecrawl-docs-improve-developers-mcp-value-props.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Cuando superas un límite de tasa o de concurrencia, la API devuelve una respuesta 429. Consulta Errores para ver el catálogo completo de errores y un fragmento de código para reintentar con backoff.
Firecrawl utiliza planes mensuales basados en suscripción. No existe un modelo estrictamente de pago por uso, pero la funcionalidad de recarga automática permite un escalado flexible. Una vez que te suscribes a un plan, puedes comprar automáticamente créditos adicionales cuando bajes de cierto umbral. Los paquetes de recarga automática más grandes ofrecen mejores precios. Para hacer pruebas antes de comprometerte con un plan más grande, empieza con el plan Free o Hobby.
Los cambios a un plan inferior entran en vigor en la siguiente renovación. No se emiten créditos por el tiempo no utilizado.
Límites de navegadores concurrentes
Los navegadores concurrentes controlan cuántas páginas puede procesar Firecrawl para ti en paralelo. Tu plan establece el límite; cualquier trabajo que lo supere esperará en una cola hasta que se libere un navegador.
El tiempo que se pasa en la cola se contabiliza en el parámetro timeout de la solicitud, por lo que puedes configurar un timeout más bajo para fallar rápido en lugar de esperar. Para consultar la disponibilidad actual antes de enviar trabajo, llama al endpoint Queue Status. Los trabajos que estén esperando en tu cola de concurrencia agotarán el tiempo de espera tras un máximo de 48 horas.
| Plan | Navegadores concurrentes | Máximo de trabajos en cola |
|---|
| Free | 2 | 50,000 |
| Hobby | 5 | 50,000 |
| estándar | 50 | 100,000 |
| crecimiento | 100 | 200,000 |
| escala / Enterprise | 150+ | 300,000+ |
Cada equipo tiene un número máximo de trabajos que pueden estar esperando en la cola de concurrencia. Si superas este límite, los nuevos trabajos se rechazarán con un código de estado 429 hasta que finalicen los trabajos existentes. En los planes más grandes con límites de concurrencia personalizados, el máximo de trabajos en cola es 2,000 veces tu límite de concurrencia, con un tope de 2,000,000.
Si necesitas límites de concurrencia más altos, contáctanos sobre los planes Enterprise.
| Plan | Concurrent Browsers | Max Queued Jobs |
|---|
| Free | 2 | 50,000 |
| Starter | 50 | 100,000 |
| Explorer | 100 | 200,000 |
| Pro | 200 | 400,000 |
Límites de tasa de la API
Los límites de tasa se miden en solicitudes por minuto y existen principalmente para evitar abusos. Cuando todo está correctamente configurado, tu verdadero cuello de botella serán los navegadores concurrentes. Los límites de tasa se aplican por equipo, por lo que todas las claves de API del mismo equipo comparten los mismos contadores de límite de tasa.
| Plan | /scrape | /map | /crawl | /search | /agent | /crawl/status | /agent/status |
|---|
| Gratis | 10 | 10 | 1 | 5 | 10 | 1500 | 500 |
| Hobby | 100 | 100 | 15 | 50 | 100 | 1500 | 25000 |
| Estándar | 500 | 500 | 50 | 250 | 500 | 1500 | 25000 |
| Crecimiento | 5000 | 5000 | 250 | 2500 | 1000 | 1500 | 25000 |
| Escala | 7500 | 7500 | 750 | 7500 | 1000 | 25000 | 25000 |
Estos límites de uso se aplican para garantizar un uso justo y la disponibilidad de la API para todos los usuarios. Si necesitas límites más altos, contáctanos en help@firecrawl.com para analizar planes personalizados.
Los endpoints de extracción comparten los mismos límites de uso que los correspondientes a /agent.
Endpoints de Batch Scrape
Los endpoints de Batch Scrape comparten los mismos límites de frecuencia que los endpoints correspondientes de /crawl.
Los endpoints del sandbox del navegador tienen límites de tasa por plan que varían según tu suscripción:
| Plan | /browser | /browser/{id}/execute |
|---|
| Free | 2 | 10 |
| Hobby | 20 | 100 |
| estándar | 100 | 500 |
| crecimiento | 1,000 | 5,000 |
| escala | 1,500 | 7,500 |
Además, el plan de cada equipo determina cuántas sesiones del navegador pueden estar activas al mismo tiempo (consulta Límites de navegadores concurrentes más arriba). Si superas este límite, las nuevas solicitudes de sesión devolverán un código de estado 429 hasta que se finalicen las sesiones existentes.
Las solicitudes que usan el agente FIRE-1 tienen límites de uso independientes, que se contabilizan por separado para cada endpoint:
| Endpoint | Límite de uso (solicitudes/min) |
|---|
| /scrape | 10 |
| /extract | 10 |
| Plan | /extract (solicitudes/min) | /extract/status (solicitudes/min) |
|---|
| Starter | 100 | 25000 |
| Explorer | 500 | 25000 |
| Pro | 1000 | 25000 |