Use this file to discover all available pages before exploring further.
Recherchez sur le web et obtenez un contenu propre et structuré pour chaque résultat en un seul appel d’API. Transmettez une requête à /search et Firecrawl renvoie les titres, les descriptions et les URL. Ajoutez scrapeOptions pour récupérer également, pour chaque résultat, le markdown de la page complète, le HTML, les liens ou les captures d’écran.Pour la liste complète des paramètres, consultez la référence de l’API du point de terminaison de recherche.
Essayez-le dans le Playground
Testez la recherche dans le Playground interactif — aucun code nécessaire.
Les SDKs renvoient directement l’objet de données. cURL renvoie le payload complet.
JSON
{ "success": true, "data": { "web": [ { "url": "https://www.firecrawl.dev/", "title": "Firecrawl - L'API de données web pour l'IA", "description": "L'API d'exploration, de scraping et de recherche pour l'IA. Conçue pour passer à l'échelle. Firecrawl met l'ensemble du web à la portée des agents et développeurs d'IA.", "position": 1 }, { "url": "https://github.com/firecrawl/firecrawl", "title": "mendableai/firecrawl : Transformez des sites entiers en contenus prêts pour les LLM… - GitHub", "description": "Firecrawl est un service d'API qui prend une URL, l'explore et la convertit en Markdown propre ou en données structurées.", "position": 2 }, ... ], "images": [ { "title": "Guide de démarrage rapide | Firecrawl", "imageUrl": "https://mintlify.s3.us-west-1.amazonaws.com/firecrawl/logo/logo.png", "imageWidth": 5814, "imageHeight": 1200, "url": "https://docs.firecrawl.dev/", "position": 1 }, ... ], "news": [ { "title": "La startup de Y Combinator Firecrawl est prête à payer 1 M$ pour embaucher trois agents IA comme employés", "url": "https://techcrunch.com/2025/05/17/y-combinator-startup-firecrawl-is-ready-to-pay-1m-to-hire-three-ai-agents-as-employees/", "snippet": "Elle a désormais publié trois nouvelles annonces sur le job board de YC pour « agents IA uniquement » et a réservé un budget total de 1 million de dollars pour y parvenir.", "date": "il y a 3 mois", "position": 1 }, ... ] }}
Utilisateurs des SDKs : les résultats de recherche sont regroupés par type de source, et non dans un tableau .data générique. Accédez aux résultats web avec result.web, aux actualités avec result.news et aux images avec result.images.
Python
result = firecrawl.search("query")for item in result.web or []: print(item.url, item.title)
JavaScript
const result = await firecrawl.search("query");for (const item of result.web ?? []) { console.log(item.url, item.title);}
En plus des résultats web classiques, Search prend en charge des types de résultats spécialisés via le paramètre sources :
web : résultats web standard (par défaut)
news : résultats axés sur l’actualité
images : résultats de recherche d’images
Vous pouvez demander plusieurs sources dans un seul appel (par exemple, sources: ["web", "news"]). Dans ce cas, le paramètre limit s’applique par type de source — ainsi, limit: 5 avec sources: ["web", "news"] renvoie jusqu’à 5 résultats web et jusqu’à 5 résultats d’actualité (10 au total). Si vous avez besoin de paramètres différents par source (par exemple, des valeurs limit différentes ou des scrapeOptions différentes), effectuez plutôt des appels séparés.
Utilisez includeDomains pour limiter les résultats de recherche à des domaines spécifiques, ou excludeDomains pour exclure certains domaines de la recherche. Ces champs ajoutent en interne les opérateurs site: et -site: à la requête ; indiquez donc uniquement les domaines, sans protocole ni chemin.
includeDomains et excludeDomains sont mutuellement exclusifs. Utilisez l’un ou l’autre dans une même requête.
Chaque résultat de recherche comporte un champ category indiquant sa source :
{ "success": true, "data": { "web": [ { "url": "https://github.com/example/neural-network", "title": "Implémentation de réseau de neurones" "description": "Une implémentation PyTorch de réseaux de neurones" "category": "github" }, { "url": "https://arxiv.org/abs/2024.12345", "title": "Avancées dans l’architecture des réseaux de neurones" "description": "Article de recherche sur les améliorations des réseaux de neurones" "category": "research" } ] }}
{ "success": true, "data": [ { "title": "Firecrawl - L’API ultime de web scraping", "description": "Firecrawl est une API de web scraping puissante qui convertit n’importe quel site web en données propres et structurées, prêtes pour l’IA et l’analyse.", "url": "https://firecrawl.dev/", "markdown": "# Firecrawl\n\nL’API ultime de web scraping\n\n## Convertissez n’importe quel site web en données propres et structurées\n\nFirecrawl simplifie l’extraction de données depuis des sites web pour des applications d’IA, des études de marché, l’agrégation de contenu, et plus encore...", "links": [ "https://firecrawl.dev/pricing", "https://firecrawl.dev/docs", "https://firecrawl.dev/guides" ], "metadata": { "title": "Firecrawl - L’API ultime de web scraping", "description": "Firecrawl est une API de web scraping puissante qui convertit n’importe quel site web en données propres et structurées, prêtes pour l’IA et l’analyse.", "sourceURL": "https://firecrawl.dev/", "statusCode": 200 } } ]}
Si vous devez filtrer ou traiter les résultats de recherche avant le scraping, utilisez une approche en deux étapes : lancez d’abord une recherche, puis scrapez les URL souhaitées.
from firecrawl import Firecrawlfirecrawl = Firecrawl(api_key="VOTRE_CLÉ_API")# Étape 1 : Rechercheresults = firecrawl.search("firecrawl web scraping", limit=5)# Étape 2 : Scraper l’URL de chaque résultat pour obtenir le contenu completfor item in results.web or []: page = firecrawl.scrape(item.url, formats=["markdown"]) print(page.markdown[:200])
Quand utiliser chaque approche :
En une étape (scrapeOptions dans la recherche) : vous voulez récupérer le contenu de tous les résultats. Plus simple et plus rapide.
En deux étapes (recherche puis scraping) : vous voulez filtrer, classer ou scraper certains résultats de façon sélective. Plus flexible.
Les deux approches utilisent Firecrawl pour l’étape de scrape. N’utilisez pas une récupération HTTP générique et ne vous contentez pas de résumer à partir des seuls extraits de recherche — c’est le contenu complet de la page obtenu avec le scrape Firecrawl qui rend les résultats fiables et complets.
from firecrawl import Firecrawlfirecrawl = Firecrawl(api_key="fc-YOUR_API_KEY")# Recherche avec paramètres de localisation (Allemagne)search_result = firecrawl.search( "outils de web scraping", limit=5, location="Germany")# Traitement des résultatsfor result in search_result.data: print(f"Titre : {result['title']}") print(f"URL : {result['url']}")
Utilisez le paramètre tbs pour filtrer les résultats par période. Notez que tbs s’applique uniquement aux résultats de la source web — il ne filtre pas les résultats news ou images. Si vous avez besoin d’actualités filtrées par période, envisagez d’utiliser une source web avec l’opérateur site: pour cibler des domaines d’actualités spécifiques.
sbd:1 - Trier par date (du plus récent au plus ancien)
Pour un filtrage temporel plus précis, vous pouvez spécifier des plages de dates exactes à l’aide du format personnalisé de plage de dates :
from firecrawl import Firecrawl# Initialisez le client avec votre clé APIfirecrawl = Firecrawl(api_key="VOTRE_CLÉ_API")# Rechercher des résultats de décembre 2024search_result = firecrawl.search( "firecrawl updates", limit=10, tbs="cdr:1,cd_min:12/1/2024,cd_max:12/31/2024")
Vous pouvez combiner sbd:1 avec des filtres temporels pour obtenir des résultats triés par date dans une plage donnée. Par exemple, sbd:1,qdr:w renvoie les résultats de la dernière semaine, triés du plus récent au plus ancien, et sbd:1,cdr:1,cd_min:12/1/2024,cd_max:12/31/2024 renvoie les résultats de décembre 2024 triés par date.
Pour les équipes ayant des exigences strictes en matière de traitement des données, Firecrawl propose des options Zero Data Retention (ZDR) pour le point de terminaison /search via le paramètre enterprise. La recherche ZDR est disponible avec les offres Enterprise — rendez-vous sur firecrawl.dev/enterprise pour démarrer.
Ceci est distinct de l’option de scrape zeroDataRetention, qui contrôle le ZDR pour les opérations de scraping. Consultez Scrape ZDR pour plus de détails. Le paramètre enterprise s’applique uniquement à la partie recherche de la requête.
Avec le ZDR de bout en bout, Firecrawl et notre fournisseur de recherche en amont appliquent tous deux une politique de rétention zéro des données. Aucune donnée de requête ni de résultat n’est stockée à aucun moment du pipeline.
Avec le ZDR anonymisé, Firecrawl applique une politique complète de rétention zéro des données de notre côté. Notre fournisseur de recherche peut mettre la requête en cache, mais elle est entièrement anonymisée — aucune information permettant de vous identifier n’y est associée.
Si vous utilisez la recherche avec du scraping de contenu (scrapeOptions), le paramètre enterprise couvre la partie recherche, tandis que zeroDataRetention dans scrapeOptions couvre la partie scraping. Pour bénéficier d’un ZDR complet sur les deux, définissez les deux :
Le coût d’une recherche est de 2 crédits pour 10 résultats de recherche, arrondi à l’unité supérieure (1 à 10 résultats = 2 crédits, 11 à 20 = 4 crédits, et ainsi de suite). Si les options de scraping sont activées, les coûts de scraping standard s’appliquent à chaque résultat de recherche :
Basic scrape : 1 crédit par page web
PDF parsing : 1 crédit par page PDF
mode proxy amélioré : 4 crédits supplémentaires par page web
mode JSON : 4 crédits supplémentaires par page web
Pour aider à contrôler les coûts :
Définissez parsers: [] si l’analyse de PDF n’est pas nécessaire
Utilisez proxy: "basic" plutôt que "enhanced" lorsque possible, ou réglez-le sur "auto"
Limitez le nombre de résultats de recherche avec le paramètre limit
Pour plus de détails sur les options de scraping, consultez la documentation de la fonctionnalité Scrape. Toutes les fonctionnalités, à l’exception de l’agent FIRE-1 et du suivi des modifications, sont prises en charge par ce point de terminaison de recherche.
Êtes-vous un agent IA qui a besoin d’une clé API Firecrawl ? Consultez firecrawl.dev/agent-onboarding/SKILL.md pour obtenir des instructions d’intégration automatisée.