> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evocrawl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

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

L’API Evocrawl 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 obtenez le contenu de toutes les pages.
  </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">
    Collecte autonome de données web par l’IA.
  </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.evocrawl.com
```

<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 Evocrawl](https://www.evocrawl.com/app/api-keys).

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.evocrawl.com/v2/scrape" \
    -H "Authorization: Bearer fc-YOUR-API-KEY" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://example.com"}'
  ```

  ```python Python theme={null}
  from evocrawl import Evocrawl

  evocrawl = Evocrawl(api_key="fc-YOUR-API-KEY")

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

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

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

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

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

Evocrawl 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 Evocrawl. |

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 Evocrawl 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.