Facturation

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 utilise un système de facturation basé sur des crédits. Chaque appel à l’API que vous effectuez consomme des crédits, et le nombre de crédits consommés dépend du point de terminaison et des options que vous utilisez. Vous disposez d’un quota mensuel de crédits en fonction de votre offre, et Smart Upgrade vous accompagne à mesure que votre utilisation augmente. Pour consulter les tarifs actuels, rendez-vous sur la page de tarification Firecrawl. Les crédits sont l’unité d’utilisation dans Firecrawl. Chaque offre inclut un quota mensuel de crédits qui est réinitialisé au début de chaque cycle de facturation. Différents endpoints d’API consomment un nombre de crédits différent. Certaines options d’extraction ajoutent des crédits en plus du coût de base par page : Ces modificateurs se cumulent. Par exemple, scraper une page avec à la fois le format JSON et le mode Enhanced coûte 1 + 4 + 4 = 9 crédits par page. Ces mêmes modificateurs s’appliquent aux points de terminaison Crawl et Search, puisqu’ils utilisent scrape en interne pour chaque page. Les crédits sont débités chaque fois que l’infrastructure de Firecrawl traite une requête, même si le site cible renvoie un code d’erreur HTTP tel que 403 Forbidden ou 404 Not Found. En effet, l’infrastructure de scraping (rendu du navigateur, proxy, etc.) est entièrement mobilisée, quelle que soit la réponse du site cible. Vous pouvez vérifier le champ metadata.statusCode dans la réponse de l’API pour détecter ces cas et éviter de relancer des URL systématiquement bloquées. Pour les tâches de batch scrape et de crawl, les crédits sont facturés de manière asynchrone à mesure que chaque page est traitée — et non au moment où la tâche est soumise. Cela signifie qu’il peut y avoir un délai entre l’envoi d’une tâche et le moment où le coût total en crédits apparaît sur votre compte. Si un batch contient de nombreuses URL ou si des pages sont mises en file d’attente pendant des périodes de fort trafic, des crédits peuvent continuer à être débités et à apparaître minutes ou heures après la soumission. Le polling ou la consultation du statut d’un batch ne consomment pas de crédits. Vous pouvez suivre votre consommation de crédits de deux manières :

• Tableau de bord : consultez votre consommation actuelle et historique sur firecrawl.dev/app
• API : utilisez les points de terminaison Credit Usage et Credit Usage Historical pour vérifier votre consommation par programmation

Firecrawl propose des offres mensuelles par abonnement. Il n’existe pas d’offre purement à l’usage, mais Smart Upgrade (décrit ci‑dessous) permet une mise à l’échelle flexible au‑delà de votre offre de base. Toutes les offres payantes sont disponibles avec une facturation mensuelle ou annuelle. La facturation annuelle propose une remise par rapport au paiement mensuel. Pour les tarifs actuels de chaque offre, consultez la page de tarification.

• Offres mensuelles : les crédits sont réinitialisés à votre date de renouvellement mensuelle
• Offres annuelles : vous êtes facturé une fois par an, mais les crédits sont tout de même réinitialisés chaque mois à votre date de renouvellement mensuelle virtuelle
• Par défaut, les crédits d’offre inutilisés ne sont pas reportés — votre quota mensuel est réinitialisé chaque mois. Les offres annuelles Scale reportent les crédits d’offre inutilisés pendant 1 mois, et les offres annuelles Enterprise les reportent pendant 2 mois.

Les navigateurs simultanés correspondent au nombre de pages web que Firecrawl peut traiter en parallèle pour vous. Votre offre détermine cette limite. Si vous la dépassez, les tâches supplémentaires attendent dans une file d’attente jusqu’à ce qu’un créneau se libère. Consultez Limites de débit pour tous les détails sur la concurrence et les limites de débit de l’API. Lorsque votre solde atteint zéro, Smart Upgrade vous fait automatiquement passer au niveau supérieur dans l’échelle des crédits, y compris aux paliers intermédiaires de chaque offre, afin que les requêtes continuent d’être traitées sans interruption. Seule la différence de prix calculée au prorata entre votre palier actuel et le suivant vous est facturée, et vous recevez immédiatement le delta de crédits correspondant. Vous pouvez désactiver Smart Upgrade à tout moment dans les paramètres de facturation. Une fois le palier Scale atteint (1 000 000 crédits/mois), il n’existe plus de palier supérieur vers lequel Smart Upgrade peut vous faire passer ; contactez l’équipe commerciale pour une offre Enterprise personnalisée. Supposons que vous soyez sur Hobby 6.5k ($28/mois ou$290/an) et que Smart Upgrade vous fasse passer à Hobby 8k ($37/mois ou$390/an). Vous recevez immédiatement 1 500 crédits supplémentaires (l’écart jusqu’à 8k), et les frais de mise à niveau dépendent de votre mode de facturation :

• Offre mensuelle : la différence mensuelle de $37 −$28 = $9 vous est facturée aujourd’hui. Votre date de renouvellement ne change pas.
• Offre annuelle, avec 5 mois restants sur votre cycle de 12 mois : le montant (5 ÷ 12) × 100 ≈ $41.67 vous est facturé aujourd’hui, la différence de prix annuelle étant de $390 −$290 = $100. Les 4 mois restants sur Hobby 8k sont couverts par ces frais, et votre date de renouvellement ne change pas.

Lorsque vous épuisez le palier 8k, l’étape suivante est Hobby 8k → Standard 100k, facturée sur la base de la différence entre ces deux paliers ($62/mois ou$600/an, calculés au prorata de la même manière), avec 92 000 crédits supplémentaires ajoutés à votre solde.

• Les mises à niveau prennent effet immédiatement. Le prix complet de la nouvelle offre vous est facturé aujourd’hui (sans prorata), et votre cycle de facturation est réinitialisé — votre prochain renouvellement aura lieu un mois ou un an après la date de mise à niveau. Tous les crédits inutilisés de votre offre précédente sont reportés, et votre nouveau quota de crédits ainsi que vos limites de concurrence s’appliquent immédiatement.
• Les rétrogradations sont programmées pour prendre effet à votre prochaine date de renouvellement. Vous conservez les crédits et limites de votre offre actuelle jusqu’à cette date, et le temps inutilisé sur votre offre actuelle n’est ni crédité ni remboursé. Vous pouvez annuler une rétrogradation programmée depuis vos paramètres de facturation à tout moment avant la date d’effet.

• Mensuel → Annuel au même niveau de crédits ou à un niveau supérieur est considéré comme une mise à niveau immédiate.
• Annuel → Mensuel est considéré comme une mise à niveau immédiate uniquement si vous passez à un niveau de crédits strictement supérieur.

Si vous épuisez votre quota de crédits et que Smart Upgrade n’est pas activé, les requêtes API qui consomment des crédits renverront une erreur HTTP 402 (Paiement requis). Avec Smart Upgrade activé, votre abonnement passe automatiquement au palier de crédits supérieur et vous recevez immédiatement le quota de crédits de ce nouveau palier, afin que les requêtes continuent sans interruption. Smart Upgrade s’arrête une fois le palier Scale atteint. Pour reprendre l’utilisation après un arrêt complet, vous pouvez :

1. Activer Smart Upgrade pour passer automatiquement au niveau supérieur
2. Passer manuellement à une offre supérieure
3. Attendre que vos crédits soient réinitialisés au prochain cycle de facturation

Firecrawl prend en charge deux types de coupons :

• Les coupons d’abonnement appliquent une réduction à votre abonnement (par ex. un pourcentage de réduction sur votre tarif mensuel ou annuel). Ils peuvent uniquement être appliqués pendant le processus de paiement Stripe, lorsque vous souscrivez pour la première fois à une offre payante ou changez d’offre. Vous ne pouvez pas appliquer un coupon d’abonnement une fois le paiement terminé.
• Les coupons de crédit ajoutent des crédits bonus à votre compte. Ils peuvent être utilisés depuis la section Facturation de votre tableau de bord à l’adresse firecrawl.dev/app/billing. Recherchez le champ de saisie du coupon sur la page de facturation pour appliquer votre code. Les crédits bonus issus des coupons de crédit sont distincts du quota mensuel de votre offre et sont conservés même si vous passez à une offre supérieure ou inférieure.