Recherche - Firecrawl Docs

L'endpoint de recherche combine la recherche web avec les capacités de scraping de Firecrawl pour renvoyer le contenu complet des pages pour n'importe quelle requête.

Incluez 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#

Nous prenons en charge une variété d’opérateurs de requête qui vous permettent de mieux filtrer vos recherches.

Opérateur	Fonctionnalité	Exemples
`""`	Correspondance exacte (non floue) d’une chaîne de texte	`"Firecrawl"`
`-`	Exclut certains mots-clés ou annule d’autres opérateurs	`-bad`, `-site:firecrawl.dev`
`site:`	Ne renvoie que les résultats d’un site web spécifié	`site:firecrawl.dev`
`filetype:`	Ne renvoie que les résultats avec une extension de fichier spécifique	`filetype:pdf`, `-filetype:pdf`
`inurl:`	Ne renvoie que les résultats qui incluent un mot dans l’URL	`inurl:firecrawl`
`allinurl:`	Ne renvoie que les résultats qui incluent plusieurs mots dans l’URL	`allinurl:git firecrawl`
`intitle:`	Ne renvoie que les résultats qui incluent un mot dans le titre de la page	`intitle:Firecrawl`
`allintitle:`	Ne renvoie que les résultats qui incluent plusieurs mots dans le titre de la page	`allintitle:firecrawl playground`
`related:`	Ne renvoie que les résultats liés à un domaine spécifique	`related:firecrawl.dev`
`imagesize:`	Ne renvoie que les images avec des dimensions exactes	`imagesize:1920x1080`
`larger:`	Ne renvoie que les images plus grandes que les dimensions spécifiées	`larger:1920x1080`

Paramètre location#

Utilisez le paramètre 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#

Utilisez le paramètre 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".

{  "query": "restaurants",  "country": "DE"}

Paramètre Categories#

Filtrez les résultats de recherche par catégories spécifiques à l’aide du paramètre categories :

research : 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 similaires). Renvoie des résultats de pages web classiques avec des snippets, et non des enregistrements de publications
pdf : recherchez des PDF
developer : 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

Note

research est un filtre de sites web, et non l’index des publications. Il limite les résultats web de ce point de terminaison à une liste fixe de domaines académiques.

Pour rechercher directement la littérature scientifique — résumés de publications sur PubMed, bioRxiv, medRxiv et arXiv, lecture de passages dans les publications et extension du graphe de citations — utilisez le Research Index via GET /search/research/papers.

Exemple d’utilisation#

{  "query": "apprentissage automatique",  "categories": ["research", "pdf"],  "limit": 10}

Filtres de domaine#

Utilisez 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#

{  "query": "web scraping",  "includeDomains": ["firecrawl.dev", "docs.firecrawl.dev"],  "limit": 10}

Exemple de domaines à exclure#

{  "query": "web scraping tools",  "excludeDomains": ["example.com"],  "limit": 10}

Catégories de la réponse#

Chaque résultat inclut un champ category indiquant sa source :

{  "success": true,  "data": {    "web": [      {        "url": "https://arxiv.org/abs/2024.12345",        "title": "ML Research Paper",        "description": "Latest advances in machine learning",        "category": "research"      },      {        "url": "https://example.com/ml-survey.pdf",        "title": "ML Survey",        "description": "A survey of machine learning methods",        "category": "pdf"      }    ]  }}

Recherche basée sur le temps#

Utilisez le paramètre 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.