Facturación

Documentation Index

Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt

Use this file to discover all available pages before exploring further.

Firecrawl utiliza un sistema de facturación basado en créditos. Cada llamada a la API que haces consume créditos, y la cantidad de créditos consumidos depende del endpoint y de las opciones que utilices. Recibes una asignación mensual de créditos según tu plan, y Smart Upgrade te mantiene cubierto a medida que crece tu uso. Para ver los precios de los planes vigentes, visita la página de precios de Firecrawl. Los créditos son la unidad de consumo en Firecrawl. Cada plan incluye una cuota mensual de créditos que se reinicia al comienzo de cada ciclo de facturación. Los distintos endpoints de la API consumen diferentes cantidades de créditos. Ciertas opciones de extracción añaden créditos sobre el costo base por página: Estos modificadores se acumulan. Por ejemplo, extraer una página con JSON format y Enhanced Mode cuesta 1 + 4 + 4 = 9 créditos por página. Estos mismos modificadores se aplican a los endpoints Crawl y Search, ya que usan scrape internamente para cada página. Los créditos se cobran siempre que la infraestructura de Firecrawl procesa una solicitud, incluso si el sitio de destino devuelve un código de estado de error HTTP como 403 Forbidden o 404 Not Found. Esto se debe a que la infraestructura de scraping (renderizado en el navegador, proxy, etc.) se utiliza por completo independientemente de la respuesta del sitio de destino. Puedes revisar el campo metadata.statusCode en la respuesta de la API para detectar estos casos y evitar reintentar URLs que se bloquean de forma constante. Para trabajos de batch scrape y crawl, los créditos se cobran de forma asíncrona a medida que cada página termina de procesarse, no cuando se envía el trabajo. Esto significa que puede haber un retraso entre el envío de un trabajo y el momento en que se refleja el costo total en créditos en tu cuenta. Si un lote contiene muchas URLs o las páginas se ponen en cola durante períodos de alto tráfico, los créditos pueden seguir registrándose minutos u horas después del envío. Hacer polling o comprobar el estado del batch no consume créditos. Puedes monitorear tu consumo de créditos de dos maneras:

• Dashboard: Consulta tu consumo actual e histórico en firecrawl.dev/app
• API: Usa los endpoints Credit Usage y Credit Usage Historical para comprobar tu consumo de forma programática

Firecrawl ofrece planes mensuales de suscripción. No existe una opción de pago por uso puro, pero Smart Upgrade (descrito más abajo) permite escalar de forma flexible por encima de tu plan base. Todos los planes de pago están disponibles con facturación mensual o anual. La facturación anual ofrece un descuento frente a pagar mes a mes. Para ver los precios actuales de cada plan, visita la página de precios.

• Planes mensuales: Los créditos se restablecen en tu fecha de renovación mensual
• Planes anuales: Se te factura anualmente, pero los créditos igual se restablecen cada mes en tu fecha de renovación mensual virtual
• Los créditos del plan no utilizados no se acumulan de forma predeterminada — tu asignación mensual se restablece cada mes. Los planes anuales Escala permiten acumular los créditos del plan no utilizados durante 1 mes, y los planes anuales Enterprise permiten acumularlos durante 2 meses.

Los navegadores concurrentes representan cuántas páginas web puede procesar Firecrawl simultáneamente para ti. Tu plan determina este límite. Si lo superas, las tareas adicionales esperarán en una cola hasta que se libere un cupo. Consulta Límites de tasa para obtener todos los detalles sobre concurrencia y límites de tasa de la API. Cuando tu saldo llega a cero, Smart Upgrade te sube automáticamente un nivel en la escala de créditos, incluidos los niveles intermedios dentro de cada plan, para que las solicitudes sigan fluyendo sin interrupciones. Solo se te factura la diferencia de precio prorrateada entre tu nivel actual y el siguiente, y recibes de inmediato la diferencia de créditos correspondiente. Puedes deshabilitar Smart Upgrade en la configuración de facturación en cualquier momento. Una vez que alcances el nivel Escala (1,000,000 créditos/mes), no hay niveles superiores a los que Smart Upgrade pueda pasar; contacta con ventas para consultar un plan Enterprise personalizado. Supongamos que estás en Hobby 6.5k ($28/mes o$290/año) y Smart Upgrade te pasa a Hobby 8k ($37/mes o$390/año). Recibes 1,500 créditos adicionales de inmediato (la diferencia hasta 8k), y el cargo por la actualización depende de tu periodicidad de facturación:

• Plan mensual: Hoy se te factura la diferencia mensual de $37 −$28 = $9. Tu fecha de renovación no cambia.
• Plan anual, con 5 meses restantes de tu ciclo de 12 meses: Hoy se te factura (5 ÷ 12) × 100 ≈ $41.67, donde la diferencia de precio anual es $390 −$290 = $100. Los 4 meses restantes en Hobby 8k quedan cubiertos por este cargo, y tu fecha de renovación no cambia.

Cuando agotas el nivel 8k, el siguiente paso es Hobby 8k → Standard 100k, y se te factura la diferencia entre esos dos niveles ($62/mes o$600/año, prorrateado de la misma manera), con 92,000 créditos adicionales añadidos a tu saldo.

• Las actualizaciones de plan surten efecto de inmediato. Hoy se te cobra el precio completo del nuevo plan (sin prorrateo) y tu ciclo de facturación se restablece: tu próxima renovación será un mes o un año después de la fecha de actualización. Los créditos no usados de tu plan anterior se transfieren, y tu nueva asignación de créditos y tus límites de concurrencia se aplican al instante.
• Los cambios a un plan inferior se programan para entrar en vigor en tu próxima fecha de renovación. Mantienes los créditos y límites de tu plan actual hasta entonces. El tiempo no usado de tu plan actual no se acredita ni se reembolsa. Puedes deshacer un cambio programado a un plan inferior desde tu configuración de facturación en cualquier momento antes de la fecha de entrada en vigor.

• Mensual → Anual en el mismo nivel de créditos o en uno superior se considera una mejora inmediata.
• Anual → Mensual se considera una mejora inmediata solo si cambias a un nivel de créditos estrictamente superior.

Si agotas tu asignación de créditos y no tienes Smart Upgrade habilitado, las solicitudes a la API que consumen créditos devolverán un error HTTP 402 (Pago requerido). Con Smart Upgrade habilitado, tu suscripción pasa automáticamente al siguiente nivel de créditos y recibes de inmediato la asignación de créditos del nuevo nivel, por lo que las solicitudes siguen procesándose sin interrupciones. Smart Upgrade deja de aplicarse cuando alcanzas el nivel Escala. Para reanudar el uso después de un bloqueo total, puedes:

1. Habilitar Smart Upgrade para subir de nivel automáticamente
2. Actualizar manualmente a un plan superior
3. Esperar a que tus créditos se restablezcan en el siguiente ciclo de facturación

Firecrawl admite dos tipos de cupones:

• Los cupones de suscripción aplican un descuento a la suscripción de tu plan (p. ej., un porcentaje de descuento en el precio mensual o anual). Estos solo se pueden aplicar durante el proceso de pago de Stripe, cuando te suscribes por primera vez a un plan de pago o cambias de plan. No puedes aplicar un cupón de suscripción una vez completado el pago.
• Los cupones de créditos añaden créditos extra a tu cuenta. Estos se pueden canjear desde la sección de Facturación de tu panel de control en firecrawl.dev/app/billing. Busca el campo de cupón en la página de facturación para aplicar tu código. Los créditos extra de los cupones de créditos son independientes de la asignación mensual de tu plan y se conservan aunque cambies a un plan superior o inferior.