Docs › Démarrage › Démarrage rapide

Démarrage rapide

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

Prérequis

Étape 1 : Obtenir votre clé API

Connectez-vous au 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) :

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

{
  "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) :

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 :

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) :

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

Mis à jour : 27 septembre 2026
Authentification →