En bref. Firecrawl Search associe la recherche web à la récupération facultative des pages et utilise scrapeOptions pour renvoyer des formats tels que Markdown et les liens.

Définition : Au 17 octobre 2026, Firecrawl Search est une interface de programmation d’applications (API) qui renvoie des résultats de recherche web et permet, dans la même requête, de récupérer le contenu des pages correspondantes.

Points clés

La documentation Search de Firecrawl décrit l’ajout de scrapeOptions pour récupérer le contenu des pages en même temps que les résultats de recherche.
La référence de l’API Search regroupe les résultats par type de source, notamment web, news et images ; la recherche web est le choix par défaut.
La documentation Scrape de Firecrawl distingue le statut de la requête API du code de statut HTTP renvoyé par le site cible.

Comment combiner recherche et récupération des pages ?

Le guide Search de Firecrawl décrit l’envoi d’une requête de recherche à /search et l’ajout de scrapeOptions pour récupérer les pages. L’extraction web (scraping) consiste à récupérer une page et à en extraire le contenu. La requête suivante reprend l’exemple du guide et demande le texte des pages au format markdown, ainsi que les liens extraits :

curl -X POST https://api.firecrawl.dev/v2/search \
  -H "Content-Type: application/json" \
  -d '{
    "query": "firecrawl web scraping",
    "limit": 3,
    "scrapeOptions": {
      "formats": ["markdown", "links"]
    }
  }'

Le guide décrit aussi une autre procédure : effectuer la recherche, filtrer ou traiter les résultats, puis appeler /scrape pour les URL retenues. Une application peut ainsi choisir les pages à récupérer avant d’en extraire le contenu.

Quels paramètres contrôlent la recherche ?

La référence de l’API définit query comme le texte de la recherche et sources comme le choix des types de résultats. Le paramètre limit s’applique à chaque type de source lorsque plusieurs types sont demandés.

includeDomains limite les résultats aux domaines indiqués, tandis que excludeDomains exclut les domaines indiqués. Ces paramètres acceptent des noms d’hôte sans protocole ni chemin et sont mutuellement exclusifs. Pour un audit de site web, une restriction par domaine définit donc les noms d’hôte couverts par la recherche.

La référence décrit également location et country pour le ciblage géographique et recommande de les renseigner ensemble. Le paramètre tbs accepte des périodes prédéfinies et des plages de dates personnalisées.

Comment vérifier la page récupérée ?

Le guide Scrape de Firecrawl explique qu’une requête API réussie peut s’accompagner d’une réponse d’erreur de la page cible. Il recommande de vérifier séparément la valeur success de la réponse API et le champ metadata.statusCode de la page cible. Le champ metadata.error peut aussi fournir des précisions sur une erreur de la page.

Le même guide distingue le HTML nettoyé, demandé avec html, du HTML non modifié, demandé avec rawHtml. Ces formats donnent des vues différentes du document récupéré. Pour un propriétaire de site qui vérifie l’extraction, comparer la sortie demandée à la page aide à identifier le texte reçu par l’application.

Termes associés

Questions fréquentes

Puis-je récupérer uniquement certains résultats de recherche ?

Oui. La documentation Search de Firecrawl décrit une procédure qui consiste à effectuer la recherche, puis à extraire le contenu des URL retenues parmi les résultats. Vous pouvez filtrer ou classer les résultats de recherche avant de récupérer le contenu des pages correspondantes.

Puis-je demander plusieurs formats de contenu ?

Oui. La documentation Scrape prévoit plusieurs formats de sortie dans une même requête, notamment Markdown, HTML et les liens. Les clés de sortie correspondent aux formats que vous choisissez.

Combien de résultats puis-je demander ?

La référence de l’API Search indique une valeur par défaut de 10 pour limit et une plage de 1 à 100. Lorsque vous demandez plusieurs types de sources, la limite s’applique à chaque type.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO