# Démarrage rapide

> URL: https://foura.ai/fr/docs/getting-started/quick-start
> Updated: 2026-09-27
> Index: https://foura.ai/llms.txt

Passez de zéro à votre première collecte de données en moins de deux minutes.

## Prérequis

- Un compte FourA ([inscrivez-vous ici](https://foura.ai))
- Votre clé API (créez-en une dans le [Dashboard](https://foura.ai/dashboard))

## Étape 1 : Obtenir votre clé API

Connectez-vous au [Dashboard](https://foura.ai/dashboard) et créez une clé API. Elle ressemble à ceci : `pk_live_a1b2c3d4e5f6...`

Copiez-la. Vous en aurez besoin pour chaque request.

## Étape 2 : Effectuer votre première request

Ouvrez un terminal et exécutez ceci (remplacez `YOUR_API_KEY` par votre clé réelle) :

```bash
curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'
```

Cela envoie une requête HTTP à `example.com` et renvoie le HTML de la page.

## Étape 3 : Lire la réponse

```json
{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}
```

Le champ `headers` est un tableau d'objets, un par saut de redirection. Chaque entree possede un champ `result` avec la ligne de statut et chaque header de reponse renvoye par la cible pour ce saut.

Champs principaux :
- `status` : code de statut HTTP du site cible
- `data` : le corps de la reponse (HTML, JSON ou texte brut)
- `total_time` : duree de la request en secondes

## Etape 4 : Essayer differents endpoints

FourA propose quatre endpoints pour differentes situations :

| Endpoint | Vitesse | Quand l'utiliser |
|----------|-------|----------|
| `POST /api/auto/` | Variable (rapide sur les hotes chauds) | Vous ne savez pas de quel moteur le site a besoin. Passez une URL et laissez FourA choisir la voie la plus economique qui fonctionne. |
| `POST /api/single/` | Le plus rapide (200ms-2s) | Pages statiques, API, sites avec rendu cote serveur |
| `POST /api/browser/` | Moyen (2s-10s) | Pages riches en JavaScript, SPA, contenu dynamique |
| `POST /api/proxy/` | Rapide (1s-5s) | Sites qui verifient l'origine des requetes, contenu variable selon le pays |

Essayez une request auto (la valeur par defaut intelligente) :

```bash
curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'
```

Essayez une requête de navigateur :

```bash
curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "timeout_ms": 15000}'
```

Testez une requête proxy (rotation automatique des proxys) :

```bash
curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 3,
    "request": {
      "method": "GET",
      "url": "https://example.com",
      "unblocker": true
    }
  }'
```

## Étapes suivantes

- [Authentification](https://foura.ai/docs/getting-started/authentication): Gestion et sécurité des clés API
- [Endpoints API](https://foura.ai/docs/api/endpoints): Référence complète des paramètres pour les quatre endpoints
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Comment l'endpoint auto détermine l'action à effectuer
- [SDK et bibliothèques](https://foura.ai/docs/getting-started/sdks-and-libraries): Exemples en Python, Node.js, Go, Ruby
- [Choisir le bon endpoint](https://foura.ai/docs/guides/choosing-task-type): Quand choisir auto, single, browser ou proxy
