/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.
Les résultats de recherche incluent par défaut des Highlights pertinents par rapport à la requête. Définissez highlights sur false si vous souhaitez plutôt la description simple ou l’extrait de chaque site web.
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
Effectuer une recherche avec Firecrawl
point de terminaison /search
Installation
Pour être éligible, participez à un entretien pertinent (cas d’utilisation concrets et réfléchis, etc.) avec notre assistant de retours Firecrawl. Cela ne prend que quelques minutes, peut être interrompu à tout moment et convient aussi bien aux humains qu’aux agents (il suffit de coller le lien dans votre harness agentique !). Cet entretien est particulièrement utile si vous effectuez des recherches ou du scraping sur des sites gouvernementaux, judiciaires, réglementaires ou d’archives publiques, et si vous avez déjà été confronté à leurs particularités.
Démarrer l’entretienIndiquez votre e-mail pour être éligible. Les entretiens sont évalués chaque fin de semaine.
Utilisation de base
Réponse
.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.Types de résultats de recherche
sources :
web: résultats web standard (par défaut)news: résultats axés sur l’actualitéimages: résultats de recherche d’images
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.
Catégories de recherche
categories :
github: recherchez dans les dépôts GitHub, le code, les tickets et la documentationresearch: limitez la recherche web aux sites web académiques et de recherche (arxiv.org, nature.com, ieee.org, pubmed.ncbi.nlm.nih.gov, biorxiv.org, medrxiv.org et sites similaires). Renvoie des résultats de pages web classiques avec des snippets — et non des fiches d’articles. Pour rechercher les articles eux-mêmes, utilisez le Research Indexpdf: recherchez des PDFdeveloper: recherchez dans le Developer Index — tickets, pull requests fusionnées et README de dépôts de code publics, ainsi que des sites de documentation sélectionnés
research est un filtre de sites web, et non l’index d’articles. Il restreint la recherche web classique à une liste fixe de domaines académiques et renvoie les snippets des pages correspondantes.Pour rechercher la littérature scientifique — résumés complets, lecture de passages dans les articles et exploration du graphe de citations à partir d’un index d’articles de PubMed, bioRxiv, medRxiv et arXiv — utilisez plutôt le Research Index.Recherche par catégorie sur GitHub
Recherche par catégorie
Recherche par catégorie dans l’index développeur
developer, à côté de web, avec la valeur category: "developer". Pour obtenir des résultats classés avec les passages correspondants, ainsi que pour utiliser les filtres par référentiel et par source de documentation, utilisez le point de terminaison de recherche pour développeurs.
Recherche multi-catégories
Filtres de domaines
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.Domaines à inclure
Domaines à exclure
Format de réponse par catégorie
category indiquant sa source :
Recherche d’images HD avec filtre de taille
imagesize:1920x1080- Full HD (1080p)imagesize:2560x1440- QHD (1440p)imagesize:3840x2160- 4K UHDlarger:1920x1080- HD et supérieurlarger:2560x1440- QHD et supérieur
Recherche avec extraction de contenu
scrapeOptions.
Réponse avec contenu extrait
Recherche puis scraping (schéma en deux étapes)
Options de recherche avancées
Personnalisation de la localisation
Recherche par plage temporelle
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.
tbs courantes :
qdr:h- Dernière heureqdr:d- Dernières 24 heuresqdr:w- Dernière semaineqdr:m- Dernier moisqdr:y- Dernière annéesbd:1- Trier par date (du plus récent au plus ancien)
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.
Délai d’attente personnalisé
Recherche sécurisée
safe sur true pour filtrer le contenu explicite des résultats de recherche (SafeSearch). S’il n’est pas renseigné, les résultats sont renvoyés sans filtrage, comme auparavant.
Zero Data Retention (ZDR)
/search via le paramètre enterprise. La recherche ZDR est disponible avec les offres Enterprise — rendez-vous sur firecrawl.dev/enterprise pour démarrer.
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.ZDR de bout en bout
- Coût : 10 crédits pour 10 résultats
- Paramètre :
enterprise: ["zdr"]
ZDR anonymisé
- Coût : 2 crédits pour 10 résultats
- Paramètre :
enterprise: ["anon"]
Combiner la recherche ZDR avec Scrape ZDR
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 :
Impact sur les coûts
- Basic scrape : 1 crédit par page web
- PDF parsing : 1 crédit par page PDF
- mode JSON : 4 crédits supplémentaires par page web
- Définissez
parsers: []si l’analyse de PDF n’est pas nécessaire - Limitez le nombre de résultats de recherche avec le paramètre
limit
Options de scraping avancées
Ê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.
Commentaires sur la recherche
POST /v2/search/{jobId}/feedback. Le premier envoi de commentaires pour un job de recherche peut donner lieu au remboursement d’1 crédit, sous réserve des limites de l’équipe, et contribue à améliorer la qualité de la recherche de Firecrawl. Voir Search Feedback.
