Recherche

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 :

github : Rechercher dans les dépôts GitHub, le code, les tickets et la documentation
research : Rechercher sur des sites académiques et de recherche (arXiv, Nature, IEEE, PubMed, etc.)
pdf : Rechercher des fichiers PDF

Exemple d’utilisation

{
  "query": "apprentissage automatique",
  "categories": ["github", "recherche"],
  "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://github.com/example/ml-project",
        "title": "Machine Learning Project",
        "description": "Implementation of ML algorithms",
        "category": "github"
      },
      {
        "url": "https://arxiv.org/abs/2024.12345",
        "title": "ML Research Paper",
        "description": "Latest advances in machine learning",
        "category": "research"
      }
    ]
  }
}

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.

On this page