# Deep Research (/fr/api-reference/v1-endpoint/deep-research)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1511 · updated: 2026-07-30 -->

Le point de terminaison Deep Research permet d’effectuer des recherches et des analyses approfondies par IA sur n’importe quel sujet. Il suffit de fournir une requête de recherche, et Firecrawl explorera le web de façon autonome, collectera les informations pertinentes et synthétisera les résultats en insights complets.

<Warning>
  Il s’agit de l’API Deep Research v1 héritée. Pour les nouveaux agents de recherche, utilisez le [cas d’usage Deep Research](/fr/use-cases/deep-research) actuel, construit à partir de Search et Scrape.
</Warning>

Vous cherchez le point de terminaison de statut ? Consultez [Deep Research Status](/fr/api-reference/v1-endpoint/deep-research-get).

<div id="response-structure">
  ### Structure de la réponse [#structure-de-la-réponse]
</div>

La réponse comprend :

* **activities** : Liste des activités de recherche avec :
  * `type` : Type d’activité (« search », « extract », « analyze », « reasoning », « synthesis », « thought »)
  * `status` : État (« processing », « complete », « error »)
  * `message` : Description de l’activité ou de la découverte
  * `timestamp` : Horodatage ISO
  * `depth` : Niveau de profondeur de la recherche

* **sources** : URL de référence avec :
  * `title` : Titre de la source
  * `description` : Description de la source
  * `url` : URL de la source
  * `icon` : Favicon de la source

* **finalAnalysis** : Analyse complète (une fois terminée)

* **status** : État global (« processing », « completed », « failed »)

* **currentDepth** : Profondeur de recherche actuelle

* **maxDepth** : Profondeur de recherche maximale

* **totalUrls** : Nombre d’URL analysées

* **expiresAt** : Horodatage ISO d’expiration des résultats

<div id="limitations">
  ### Limitations [#limitations]
</div>

1. Idéal pour des sujets dont les informations sont publiquement disponibles
2. Tâches de recherche limitées à 10 minutes maximum
3. Vérification manuelle recommandée pour les informations critiques
4. Fonctionnalité en alpha — la méthodologie et les résultats peuvent évoluer

<div id="billing">
  ### Facturation [#facturation]
</div>

La facturation dépend du nombre d’URL analysées :

* Chaque URL = 1 crédit
* Gérez votre utilisation avec le paramètre `maxUrls`

`POST /deep-research`

Lancer une recherche approfondie pour une requête

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "analysisPrompt": {
              "description": "Le prompt à utiliser pour l’analyse finale. Utile pour formater le markdown de l’analyse finale d’une manière spécifique.",
              "type": "string"
            },
            "formats": {
              "default": [
                "markdown"
              ],
              "items": {
                "enum": [
                  "markdown",
                  "json"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "jsonOptions": {
              "description": "Options de sortie au format JSON",
              "properties": {
                "prompt": {
                  "description": "Le prompt à utiliser pour la sortie au format JSON",
                  "type": "string"
                },
                "schema": {
                  "description": "Le schéma à utiliser pour la sortie JSON. Doit être conforme à JSON Schema (https://json-schema.org/).",
                  "type": "object"
                },
                "systemPrompt": {
                  "description": "Le prompt système à utiliser pour la sortie au format JSON",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "maxDepth": {
              "default": 7,
              "description": "Profondeur maximale des itérations de recherche",
              "maximum": 12,
              "minimum": 1,
              "type": "integer"
            },
            "maxUrls": {
              "default": 20,
              "description": "Nombre maximal d’URL à analyser",
              "maximum": 1000,
              "minimum": 1,
              "type": "integer"
            },
            "query": {
              "description": "La requête à étudier",
              "type": "string"
            },
            "systemPrompt": {
              "description": "L’invite système à utiliser pour l’agent de recherche. Permet d’orienter l’agent de recherche dans une direction précise.",
              "type": "string"
            },
            "timeLimit": {
              "default": 300,
              "description": "Limite de temps (en secondes)",
              "maximum": 600,
              "minimum": 30,
              "type": "integer"
            }
          },
          "required": [
            "query"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "id": {
                "description": "ID de la tâche de recherche",
                "format": "uuid",
                "type": "string"
              },
              "success": {
                "example": true,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "La tâche de recherche a bien démarré"
    },
    "400": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Invalid parameters provided",
                "type": "string"
              },
              "success": {
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Paramètres de la requête invalides"
    }
  }
}
```