Recherche
scrapeOptions avec formats: [{"type": "markdown"}] pour obtenir le contenu markdown complet pour chaque résultat de recherche ; sinon, vous recevrez par défaut les résultats (URL, title, description). Vous pouvez également utiliser d’autres formats comme {"type": "summary"} pour un contenu condensé.
Opérateurs de requête pris en charge
Paramètre location
location pour obtenir des résultats de recherche géociblés. Format : "string". Exemples : "Germany", "San Francisco,California,United States".
Consultez la liste complète des emplacements pris en charge pour tous les pays et langues disponibles.
Paramètre country
country pour définir le pays des résultats de recherche à l’aide des codes de pays ISO. Valeur par défaut : "US".
Exemples : "US", "DE", "FR", "JP", "UK", "CA".
Paramètre categories
categories :
github: Rechercher dans les dépôts GitHub, le code, les tickets et la documentationresearch: Rechercher sur des sites académiques et de recherche (arXiv, Nature, IEEE, PubMed, etc.)pdf: Rechercher des fichiers PDF
Exemple d’utilisation
Filtres de domaine
includeDomains pour limiter les résultats à des domaines spécifiques, ou excludeDomains pour exclure certains domaines de la recherche. Les domaines doivent être uniquement des noms d’hôte, sans protocole ni chemin.
includeDomains et excludeDomains sont mutuellement exclusifs.
Exemple de domaines à inclure
Exemple de domaines à exclure
Catégories de la réponse
category indiquant sa source :
Recherche basée sur le temps
tbs pour filtrer les résultats par périodes, y compris avec des intervalles de dates personnalisés. Consultez la documentation de la fonctionnalité de recherche pour des exemples détaillés et les formats pris en charge.
Êtes-vous un agent IA ayant besoin d’une clé API Firecrawl ? Consultez firecrawl.dev/agent-onboarding/SKILL.md pour obtenir des instructions d’intégration automatisée.
Autorisations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Corps
La requête de recherche
500Catégories utilisées pour filtrer les résultats. Par défaut, la valeur est [], ce qui signifie qu’aucun filtre de catégorie ne sera appliqué aux résultats.
- GitHub
- Research
- PDF
Code pays ISO pour le ciblage géographique des résultats de recherche (par exemple US). Pour de meilleurs résultats, définissez ce paramètre ainsi que le paramètre location.
Options de search Enterprise pour la rétention zéro des données (ZDR). Utilisez ["zdr"] pour un ZDR de bout en bout (10 credits / 10 résultats) ou ["anon"] pour un ZDR anonymisé (2 credits / 10 résultats). Doit être activé pour votre équipe.
anon, zdr Exclut les résultats de recherche des domaines indiqués. Les domaines doivent être uniquement des noms d’hôte, sans protocole ni chemin. Ne peut pas être utilisé avec includeDomains.
Génère des passages pertinents pour la requête, mis en évidence dans les résultats de recherche. Définissez cette option sur false pour renvoyer des descriptions ou des extraits du fournisseur, sans mise en évidence.
Exclut des résultats de recherche les URL qui ne sont pas valides pour d’autres endpoints Firecrawl. Cela permet de réduire les erreurs si vous transmettez les données issues de la recherche vers d’autres endpoints de l’API Firecrawl.
Limite les résultats de recherche aux domaines indiqués. Les domaines doivent être uniquement des noms d’hôte, sans protocole ni chemin. Ne peut pas être utilisé avec excludeDomains.
Nombre maximal de résultats à renvoyer (par type de source en cas d’utilisation de plusieurs sources)
1 <= x <= 100Paramètre de localisation pour les résultats de recherche (par ex. San Francisco,California,United States). Pour de meilleurs résultats, définissez ce paramètre ainsi que le paramètre country.
Options pour extraire les résultats de recherche
Sources à interroger. Déterminera les tableaux disponibles dans la réponse. Valeur par défaut : ['web'].
- Web
- Images
- News
Paramètre de recherche temporel. Accepte des intervalles prédéfinis (qdr:h, qdr:d, qdr:w, qdr:m, qdr:y), des plages de dates personnalisées (cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY) ainsi que le tri par date (sbd:1). Les valeurs peuvent être combinées, par exemple : sbd:1,qdr:w.
Dérogation Protection contre les menaces au niveau de la requête. Les champs que vous fournissez remplacent les champs correspondants de la politique de votre organisation pour cette requête uniquement ; les champs omis conservent leurs valeurs définies au niveau de l'organisation. La Protection contre les menaces doit être activée pour votre équipe (fonctionnalité Enterprise) ; sinon, la requête est rejetée avec un code 403. Si votre organisation a désactivé les dérogations par requête, toute requête qui inclut cet objet est rejetée avec un code 403. Si la Protection contre les menaces est appliquée à votre équipe, mode ne peut pas être défini sur off.
Délai d'expiration en millisecondes
Réponse
Réponse en cas de succès
Nombre de crédits utilisés pour la recherche
Les résultats de la recherche. Les tableaux disponibles dépendront des sources que vous avez spécifiées dans la requête. Par défaut, le tableau web sera renvoyé.
L’ID de la tâche de recherche
Message d’avertissement si des problèmes surviennent

