# 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é.

<div id="supported-query-operators">
  ## Opérateurs de requête pris en charge
</div>

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`

<div id="location-parameter">
  ## Paramètre location
</div>

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](https://firecrawl.dev/search_locations.json) pour tous les pays et langues disponibles.

<div id="country-parameter">
  ## Paramètre country
</div>

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"`.

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

<div id="categories-parameter">
  ## Paramètre Categories
</div>

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](/fr/features/developer) — 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](/fr/features/research) via [`GET /search/research/papers`](/fr/api-reference/endpoint/research-search-papers).
</Note>

<div id="example-usage">
  ### Exemple d’utilisation
</div>

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

<div id="domain-filters">
  ## Filtres de domaine
</div>

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.

<div id="include-domains-example">
  ### Exemple de domaines à inclure
</div>

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

<div id="exclude-domains-example">
  ### Exemple de domaines à exclure
</div>

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

<div id="category-response">
  ### Catégories de la réponse
</div>

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

```json
{
  "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"
      }
    ]
  }
}
```

<div id="time-based-search">
  ## Recherche basée sur le temps
</div>

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](https://docs.firecrawl.dev/features/search#time-based-search) 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](https://www.firecrawl.dev/agent-onboarding/SKILL.md) pour obtenir des instructions d’intégration automatisée.