> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-dne9il.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Deep Research

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
</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
</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
</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`


## OpenAPI

````yaml fr/api-reference/v1-openapi.json POST /deep-research
openapi: 3.0.0
info:
  contact:
    email: support@firecrawl.dev
    name: Firecrawl Support
    url: https://firecrawl.dev/support
  description: >-
    API permettant d’interagir avec les services Firecrawl pour réaliser des
    tâches de scraping et de crawling web.
  title: Firecrawl API
  version: v1
servers:
  - url: https://api.firecrawl.dev/v1
security:
  - bearerAuth: []
paths:
  /deep-research:
    post:
      tags:
        - Research
      summary: Lancer une recherche approfondie pour une requête
      operationId: startDeepResearch
      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
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````