> ## Documentation Index
> Fetch the complete documentation index at: https://student-213fb9fc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Référence de l’API Firecrawl (v2)

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.

<div id="features">
  ## Fonctionnalités
</div>

<CardGroup cols={3}>
  <Card title="Scrape" icon="markdown" href="/fr/api-reference/endpoint/scrape" color="FF713C">
    Extrayez le contenu de n’importe quelle page web aux formats markdown ou JSON.
  </Card>

  <Card title="Crawl" icon="spider" href="/fr/api-reference/endpoint/crawl-post" color="FF713C">
    Explorez des sites entiers et extrayez leur contenu ainsi que leurs métadonnées.
  </Card>

  <Card title="Map" icon="map" href="/fr/api-reference/endpoint/map" color="FF713C">
    Obtenez rapidement une liste complète des URL d’un site web, de façon fiable.
  </Card>

  <Card title="Search" icon="magnifying-glass" href="/fr/api-reference/endpoint/search" color="FF713C">
    Recherchez sur le web et récupérez le contenu complet des pages dans le format de votre choix.
  </Card>
</CardGroup>

<div id="agentic-features">
  ## Fonctionnalités d’agent
</div>

<CardGroup cols={3}>
  <Card title="Agent" icon="robot" href="/fr/api-reference/endpoint/agent" color="FF713C">
    Naviguer de manière autonome et extraire des données structurées à partir de sites web.
  </Card>

  <Card title="Navigateur" icon="browser" href="/fr/api-reference/endpoint/browser-create" color="FF713C">
    Créer et contrôler des sessions de navigateur pour des tâches web interactives.
  </Card>
</CardGroup>

<div id="base-url">
  ## URL de base
</div>

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

```bash theme={null}
https://api.firecrawl.dev
```

<div id="authentication">
  ## Authentification
</div>

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

```bash theme={null}
Authorization: Bearer fc-YOUR-API-KEY
```

Incluez cet en-tête dans tous les appels à l'API. Vous pouvez trouver votre clé API dans le [tableau de bord Firecrawl](https://www.firecrawl.dev/app/api-keys).

<CodeGroup>
  ```bash cURL theme={null}
  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"}'
  ```

  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")

  result = firecrawl.scrape("https://example.com")
  ```

  ```js Node theme={null}
  import Firecrawl from '@mendable/firecrawl-js';

  const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

  const result = await firecrawl.scrape('https://example.com');
  ```
</CodeGroup>

<div id="response-codes">
  ## Codes de réponse
</div>

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.

| Statut | Description                             |
| ------ | --------------------------------------- |
| `200`  | La requête a réussi.                    |
| `400`  | Paramètres de requête invalides.        |
| `401`  | Clé d'API manquante ou invalide.        |
| `402`  | Paiement requis.                        |
| `404`  | La ressource demandée est introuvable.  |
| `429`  | Limite de débit dépassée.               |
| `5xx`  | Erreur de serveur du côté de Firecrawl. |

Lorsqu'une erreur `5xx` se produit, le corps de la réponse inclut un code d'erreur spécifique pour vous aider à diagnostiquer le problème.

<div id="rate-limit">
  ## Limitation de débit
</div>

L'API Firecrawl applique des limitations de débit sur tous les endpoints afin de garantir la stabilité du service. Ces limitations sont basées sur le nombre de requêtes au sein d'une fenêtre temporelle donnée.

Lorsque vous dépassez la limitation de débit, l'API renvoie un code de statut `429`. Réduisez temporairement la fréquence des requêtes et réessayez après un court délai.