| 400 | Bad Request / message de validation | Le corps de la requête ne respecte pas le schéma (champs manquants ou invalides). | Corrigez le payload de la requête à l’aide de la référence du point de terminaison. Consultez details pour identifier les champs en cause. | Non |
| 400 | Invalid URL | Le champ url est absent, mal formé ou utilise un schéma non pris en charge. | Fournissez une URL absolue en http(s)://. | Non |
| 400 | THIRD_PARTY_DATA_UNSUPPORTED_URL | L’URL appartient à un site pris en charge par un provider de données tiers, mais ce provider ne fournit que la page propre d’un enregistrement (par exemple une page de profil), et non les sous-pages qui en dépendent. La réponse contient cette valeur dans code. | Effectuez l’extraction de la page propre à l’enregistrement plutôt que d’une sous-page ou d’une fiche produit qui en dépend. | Non |
| 400 | THIRD_PARTY_DATA_UNSUPPORTED_OPTION | Cette URL ne peut être servie que par un provider de données tiers (par exemple un profil LinkedIn), et la requête définit une option que le provider ne prend pas en charge : actions, profile, minAge, zeroDataRetention, lockdown, redactPII, ou un format non pris en charge comme screenshot ou branding. error indique l’option en cause. La réponse contient cette valeur dans code. | Renvoyez la requête sans cette option. Si la politique de votre équipe impose la conservation zéro des données, ces URL ne peuvent pas être traitées. Consultez URL routées via un provider. | Non |
| 401 | Unauthorized: Invalid token | La clé API est absente, mal formée ou révoquée. | Envoyez Authorization: Bearer fc-... avec une clé valide, disponible dans le tableau de bord. | Non |
| 402 | Payment Required: Insufficient credits | Les crédits de l’offre sont épuisés ou la facturation n’est pas configurée. | Activez le paiement à l’usage ou effectuez une mise à niveau de votre offre. | Non |
| 403 | Forbidden | La clé ne dispose pas des autorisations nécessaires pour ce point de terminaison ou cette fonctionnalité. | Utilisez une clé disposant de la portée obligatoire ou effectuez une mise à niveau de votre offre pour accéder à cette fonctionnalité. | Non |
| 403 | SCRAPE_PROMPT_INJECTION_DETECTED | L’option checkPromptInjection a détecté une tentative d’injection de prompt dans le contenu de la page scrapée ; l’extraction a donc été annulée. | Examinez manuellement le contenu de la page. S’il s’agit d’un faux positif, relancez la requête sans checkPromptInjection. Voir Détection des injections de prompt. | Non |
| 403 | THIRD_PARTY_DATA_NOT_ENABLED | Le provider de données tierces associé à cette URL n’est pas activé pour votre organisation, par exemple parce qu’un administrateur de l’organisation l’a désactivé. La réponse contient cette valeur dans code. | Demandez à un administrateur de l’organisation d’activer le provider depuis sa page Alexandria, ou retirez-le de vos providers d’enrichissement. | Après son activation |
| 403 | THIRD_PARTY_DATA_ENRICHMENT_NOT_ENABLED | L’URL correspond à un profil ou à une page d’entreprise LinkedIn, mais l’enrichissement est désactivé pour ce type de profil, ou aucun de vos providers d’enrichissement enregistrés ne peut la prendre en charge. La réponse contient cette valeur dans code, et error renvoie vers les paramètres d’enrichissement. | Demandez à un administrateur de l’organisation d’activer l’enrichissement et de sélectionner des providers dans les paramètres d’enrichissement. Voir URL routées vers un provider. | Après configuration |
| 403 | We apologize for the inconvenience but we do not support this site... / UNSUPPORTED_SITE | Firecrawl n’effectue pas d’extraction sur ce site, et aucun provider de données tiers ne dessert cette URL. Certaines réponses contiennent également UNSUPPORTED_SITE dans code. | Utilisez une autre source pour ces données. Les clients Enterprise peuvent contacter l’équipe commerciale à propos de ce site. | Non |
| 403 | THIRD_PARTY_DATA_TERMS_REQUIRED | Un provider Alexandria exige que votre organisation accepte ses conditions avant de pouvoir exécuter la requête. Le provider n’a pas été exécuté. La réponse contient cette valeur dans code, ainsi que requiresAction.url. | Transmettez requiresAction.url à un administrateur de l’organisation, qui pourra y examiner et accepter les conditions. Les agents ne doivent jamais accepter les conditions de leur propre initiative. Une fois les conditions acceptées, renvoyez la même requête. | Après acceptation |
| 404 | Not Found | L’ID de tâche, la ressource ou le chemin du point de terminaison n’existe pas. | Vérifiez l’ID de la ressource et l’URL du point de terminaison. | Non |
| 404 | THIRD_PARTY_DATA_NOT_FOUND | L’URL est servie par des providers de données tiers, et aucun d’entre eux ne possède d’enregistrement correspondant. Si plusieurs providers d’enrichissement sont configurés, ils ont tous été interrogés. Un provider sans enregistrement ne facture rien. La réponse contient cette valeur dans code. | Vérifiez que l’URL pointe vers un profil ou une page d’entreprise qui existe. L’ajout de providers d’enrichissement peut améliorer la couverture. | Non |
| 408 | Request Timeout | Le chargement de la page a dépassé le délai d’expiration (timeout) de la requête. | Augmentez la valeur de timeout, simplifiez les actions ou utilisez fastMode. | Oui, avec un backoff exponentiel |
| 409 | Conflict | L’état de la ressource empêche l’opération (par exemple, la ressource a déjà été supprimée). | Récupérez à nouveau l’état et résolvez les incohérences avant de réessayer. | Non |
| 413 | Payload Too Large | Le corps de la requête dépasse la taille maximale autorisée. | Réduisez la charge utile (p. ex. un schéma plus court ou moins d’URL par lot). | Non |
| 422 | Unprocessable Entity / erreur de schéma d’extraction | Le schéma ne respecte pas la spécification JSON Schema, ou le modèle n’a pas pu produire un résultat conforme. | Validez le schéma ; assouplissez les champs obligatoires ; essayez un autre model. | Parfois |
| 429 | Rate limit exceeded | Le nombre de requêtes dépasse la limite par minute de votre offre. | Espacez vos requêtes et réessayez après le délai indiqué (en secondes) par Retry-After. Consultez Limites de débit. | Oui, avec backoff exponentiel |
| 429 | Concurrency limit reached | La limite de navigateurs simultanés autorisés par votre offre est atteinte. | Attendez la fin des tâches en cours, réduisez la concurrence ou effectuez une mise à niveau de votre offre. | Oui, avec un backoff exponentiel |
| 500 | Internal Server Error | Erreur non gérée côté serveur. | Réessayez avec un backoff exponentiel. Si le problème persiste, contactez l’assistance en indiquant l’identifiant de la requête. | Oui, avec un backoff exponentiel |
| 502 | Bad Gateway | Le proxy ou le processus de traitement en amont a renvoyé une réponse invalide. | Réessayez avec un backoff exponentiel. | Oui, avec un backoff exponentiel |
| 503 | Service Unavailable | Le service ne peut temporairement pas traiter la requête. | Réessayez avec un backoff exponentiel. | Oui, avec un backoff exponentiel |
| 504 | Gateway Timeout | La requête a dépassé le délai d’expiration de la passerelle (généralement lors de crawls de longue durée). | Utilisez plutôt les points de terminaison asynchrones crawl/batch et interrogez régulièrement l’état de l’opération. | Oui, avec backoff exponentiel |