Introduction

Pour les agents IA : Utilisez llms.txt pour obtenir un index complet de toute la documentation.

L’API Firecrawl vous donne un accès programmatique aux données issues du web. Tous les endpoints utilisent la même URL de base, le même schéma d’authentification et le même format de réponse, décrits sur cette page.

Fonctionnalités

Scrape

Extrayez le contenu de n’importe quelle page web aux formats markdown ou JSON.

Parse

Importez des fichiers et convertissez-les en markdown ou dans d’autres formats.

Crawl

Explorez des sites entiers et obtenez le contenu de toutes les pages.

Map

Obtenez rapidement une liste complète des URL d’un site web, de façon fiable.

Search

Recherchez sur le web et récupérez le contenu complet des pages dans le format de votre choix.

Fonctionnalités d’agent

Agent

Collecte autonome de données web par l’IA.

Navigateur

Créer et contrôler des sessions de navigateur pour des tâches web interactives.

URL de base

Toutes les requêtes utilisent l’URL de base suivante :

https://api.firecrawl.dev

Authentification

Chaque requête doit inclure un en-tête Authorization contenant votre clé d’API :

Authorization: Bearer fc-YOUR-API-KEY

Incluez cet en-tête dans tous les appels à l’API. Vous pouvez trouver votre clé d’API dans le tableau de bord Firecrawl.

Si vous êtes un agent sans clé d’API, commencez par Obtenir les identifiants. Si votre plateforme prend en charge WorkOS ID-JAG, utilisez auth.md pour les instructions d’inscription.

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"}'

Codes de réponse

Firecrawl utilise des codes d’état HTTP standard pour indiquer le résultat de vos requêtes. Les codes de la plage 2xx indiquent une réussite, les codes 4xx indiquent des erreurs côté client et les codes 5xx indiquent des erreurs côté serveur.

Voir Errors pour la référence complète, y compris la chaîne error renvoyée pour chaque type d’échec, des recommandations de réessai et un extrait de backoff exponentiel à copier-coller.

Réponses 429

Lorsque vous dépassez les limites de débit ou de concurrence de votre offre, l’API renvoie un code d’état 429. Consultez Limites de débit pour connaître les limites par offre et Errors pour savoir comment réessayer.