# Choisir le bon endpoint

> URL: https://foura.ai/fr/docs/guides/choosing-task-type
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

FourA propose quatre endpoints de requête, chacun optimisé pour un scénario différent. Choisir le bon vous fait gagner du temps, réduit vos coûts et améliore vos taux de réussite.

## Guide de décision rapide

**Utilisez l'endpoint auto quand :**
- Vous ciblez un nouveau site et vous ne connaissez pas encore ses exigences
- Vous souhaitez un seul appel qui gère pour vous la rotation de proxy et les basculements vers un navigateur
- Vous voulez une session rejouable à faible coût lors du prochain appel vers le même hôte

**Utilisez l'endpoint single quand :**
- La page est générée côté serveur (aucun JavaScript requis)
- Vous avez besoin d'une vitesse maximale (généralement moins de 1 seconde)
- Vous appelez des API ou des pages HTML statiques depuis un hôte dont vous connaissez déjà le fonctionnement

**Utilisez l'endpoint browser quand :**
- La page dépend de JavaScript pour afficher son contenu
- Le contenu se charge après le chargement initial de la page
- Vous avez besoin du DOM entièrement rendu

**Utilisez l'endpoint proxy quand :**
- Le site cible bloque activement les requêtes
- Vous devez alterner entre plusieurs adresses IP
- Les tentatives précédentes ont renvoyé des erreurs 403 ou des pages de vérification

## Comparaison des endpoints

### Auto (`POST /api/auto/`)

L'endpoint de récupération intelligente. Vous transmettez une URL et (idéalement) une règle `validate`, puis FourA parcourt une séquence progressive optimisée pour les coûts : d'abord un proxy avec rotation, puis un navigateur complet via un proxy. Définissez `forceProxy: false`, et une sonde directe économique ainsi qu'un rendu direct par navigateur s'exécuteront avant ces deux étapes. Le premier niveau renvoyant une réponse conforme à votre `validate` l'emporte. Lors des appels répétés vers le même hôte, une session active est rejouée, rendant le deuxième appel peu coûteux.

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

**Temps de réponse typique :** 200 ms (à chaud) à plus de 30 s (résolution à froid sur un site complexe)
**Idéal pour :** nouvelles cibles, sites à protection mixte, cas où vous voulez simplement la page

Pour un guide plus détaillé, consultez le [guide Smart Fetch](https://foura.ai/docs/guides/smart-fetch).

### Single (`POST /api/single/`)

L'option la plus rapide. Envoie une requête HTTP avec des caractéristiques réseau réalistes similaires à celles d'un navigateur, sans lancer de processus de navigateur.

```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/api/products"}'
```

**Temps de réponse standard :** 200 ms à 2 s
**Idéal pour :** API, sites d'actualités, blogs, pages produits statiques

### Browser (`POST /api/browser/`)

Ouvre votre URL dans une instance de navigateur Chrome. La page se charge entièrement, le JavaScript s'exécute et vous obtenez le HTML final rendu.

```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/spa-app",
    "timeout_ms": 15000,
    "checkText": "data-table"
  }'
```

**Temps de réponse standard :** 2 s à 10 s
**Idéal pour :** les applications monopages (SPA), les sites avec chargement différé, le contenu généré par JavaScript

### Proxy (`POST /api/proxy/`)

Combine les requêtes HTTP avec une rotation automatique des proxys. Si la première tentative échoue ou se retrouve bloquée, FourA réessaie via différents 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": 5,
    "request": {
      "method": "GET",
      "url": "https://example.com/pricing"
    }
  }'
```

**Temps de réponse typique :** 1 s à 5 s
**Idéal pour :** surveillance des prix e-commerce, agrégation de voyages, sites avec détection de bots

## Auto vs Manuel

Quand devez-vous laisser auto choisir, et quand devez-vous appeler vous-même Single, Proxy ou Browser ?

| Choisir auto | Choisir manuel |
|-----------|-------------|
| Vous ne savez pas encore ce dont le site a besoin | Vous savez exactement quel moteur la cible requiert |
| Vous voulez un appel unique qui fonctionne directement | Vous optimisez la structure de la requête pour une cible connue |
| La réutilisation par auto d'une session mémorisée vous convient | Vous voulez un contrôle total sur les tentatives, le timeout et le choix du proxy par appel |
| Vous acceptez quelques secondes de test lors du premier appel | La latence du premier appel compte plus que la découverte |

Auto n'est pas toujours le choix le plus économique. Si vous savez déjà qu'une cible fonctionne avec Single et `unblocker` activé, appeler Single directement ignore les paliers et coûte 2 crédits. Auto sur la même cible coûte ce que ses paliers consomment.

## Quand combiner les approches

Certains workflows tirent profit de l'utilisation de plusieurs endpoints :

1. **Découvrir avec auto** : passez une règle `validate` et laissez le mécanisme déterminer le palier requis par le site.
2. **Rejouer avec single** : récupérez les paramètres `session.proxy`, `session.cookies` et `session.userAgent` renvoyés par auto, puis appelez Single avec ceux-ci pour les pages suivantes sur le même hôte.
3. **Basculer vers browser** : si single commence à échouer, passez au rendu par navigateur.
4. **Ajouter proxy** : si vous rencontrez des refus (403 ou page de vérification) sans auto, encapsulez votre requête dans l'endpoint proxy pour une rotation automatique.

Cette approche progressive maintient un coût réduit tout en assurant des taux de réussite élevés.

## Conseils de performance

- Passez une sous-chaîne `validate.data.accept` sur les cibles protégées. Auto reconnaît de lui-même les pages d'interposition courantes, mais seule votre règle peut intercepter une page de vérification inconnue ou une page chargée sans le contenu requis.
- Utilisez l'endpoint single par défaut pour les hôtes vérifiés et ne changez de niveau que si nécessaire.
- Définissez `checkText` dans les requêtes browser afin qu'une page rendue sans votre contenu renvoie un échec (`checkText:<text> not found`) au lieu d'un succès. `checkText` ne force pas FourA à attendre le texte plus longtemps.
- Configurez `maxTries` dans les requêtes proxy pour contrôler les tentatives de rejeu (la valeur par défaut est 5, le maximum est 90).
- Conservez une valeur raisonnable pour `timeout_ms` : 10 à 15 secondes pour la plupart des pages, plus de 30 s pour les exécutions auto initiales sur des sites protégés.

## Étapes suivantes

- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch) : Analyse détaillée de `/api/auto/`
- [API Endpoints](https://foura.ai/docs/api/endpoints) : Référence complète des paramètres
- [Scrape a Dynamic Website](https://foura.ai/docs/how-to/scrape-dynamic-website) : Guide étape par étape pour les requêtes browser
- [Quick Start](https://foura.ai/docs/getting-started/quick-start) : Votre première requête en 30 secondes
