Choisir le bon endpoint

FourA propose quatre endpoints de requête, chacun optimisé pour un scénario différent. Choisir le bon permet de gagner du temps, de réduire les coûts et d'améliorer les taux de réussite.

Guide de décision rapide

Utilisez l'endpoint auto lorsque :

• Vous ciblez un nouveau site et vous ne savez pas encore ce dont il a besoin
• Vous voulez un seul appel qui gère pour vous les requêtes directes, la rotation de proxy et les solutions de repli via navigateur
• Vous souhaitez une session que vous pouvez rejouer à faible coût lors de l'appel suivant vers le même hôte

Utilisez l'endpoint single lorsque :

• La page est rendue côté serveur (aucun JavaScript requis)
• Vous avez besoin de la vitesse maximale (généralement moins de 1 seconde)
• Vous interrogez des API ou des pages HTML statiques à partir d'un hôte dont vous savez déjà qu'il fonctionne

Utilisez l'endpoint browser lorsque :

• La page s'appuie sur JavaScript pour rendre le 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 lorsque :

• Le site cible bloque activement les requêtes
• Vous devez effectuer une rotation sur plusieurs adresses IP
• Les tentatives précédentes ont renvoyé des erreurs 403 ou des pages CAPTCHA

Comparaison des endpoints

Auto (POST /api/auto/)

L'endpoint smart-fetch. Vous transmettez une URL et (idéalement) une règle validate, et FourA parcourt une échelle sensible aux coûts : test direct peu coûteux, proxy avec rotation, navigateur complet. Le premier échelon qui renvoie une réponse correspondant à votre validate l'emporte. Lors d'appels répétés vers le même hôte, une session chaude est rejouée, de sorte que le deuxième appel est peu coûteux.

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) à 30 s+ (résolution à froid sur un site difficile) Idéal pour : Les nouvelles cibles, les sites à protection mixte, "Je veux juste la page"

Pour une présentation plus détaillée, consultez le guide Smart Fetch.

Single (POST /api/single/)

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

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 typique : 200 ms à 2 s Idéal pour : Les API, les sites d'actualités, les blogs, les pages de produits statiques

Browser (POST /api/browser/)

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

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 typique : 2 s à 10 s Idéal pour : Les applications à page unique (SPA), les sites avec chargement différé, le contenu rendu par JavaScript

Proxy (POST /api/proxy/)

Combine les requêtes HTTP avec une rotation de proxy automatique. Si la première tentative échoue ou est bloquée, FourA réessaie via différents proxies.

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 : La surveillance des prix e-commerce, l'agrégation de voyages, les sites dotés d'une 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 ?

Auto n'est pas toujours le choix le moins cher. Si vous savez déjà qu'une cible fonctionne avec Single et unblocker activé, appeler Single directement ignore l'analyse et coûte 2 crédits. Auto sur la même cible coûte ce que son échelle dépense.

Quand combiner les approches

Certains workflows bénéficient de l'utilisation de plusieurs endpoints :

1. Découvrir avec auto : transmettez une règle validate et laissez l'échelle déterminer de quel échelon le site a besoin.
2. Rejouer avec single : prenez le session.proxy, session.cookies et session.userAgent renvoyés par auto, puis appelez Single avec eux pour les pages suivantes sur le même hôte.
3. Se rabattre sur browser : si single commence à échouer, passez au rendu navigateur.
4. Ajouter un proxy : si vous êtes bloqué (403 / CAPTCHA) sans auto, enveloppez votre requête dans l'endpoint proxy pour une rotation automatique.

Cette approche progressive maintient les coûts bas tout en conservant des taux de réussite élevés.

Conseils de performances

• Transmettez une sous-chaîne validate.data.accept sur les cibles protégées. Sans cela, auto ne peut pas distinguer une page réelle d'un interstitiel de défi.
• Utilisez l'endpoint single par défaut pour les hôtes fonctionnels connus et ne passez au niveau supérieur qu'en cas de besoin.
• Définissez checkText dans les requêtes browser pour éviter d'attendre du contenu inutile.
• Définissez maxTries dans les requêtes proxy pour contrôler le comportement des nouvelles tentatives (la valeur par défaut est 5, le maximum est 90).
• Maintenez timeout_ms raisonnable : 10 à 15 secondes pour la plupart des pages, 30 s+ pour les exécutions auto à froid contre les sites protégés.

Étapes suivantes

• Smart Fetch (Auto) : l'analyse approfondie sur /api/auto/
• API Endpoints : référence complète des paramètres
• Scraper un site web dynamique : guide étape par étape des requêtes browser
• Démarrage rapide : votre première requête en 30 secondes