> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Recherche dans la documentation

> Répondez aux questions sur la documentation Firecrawl à l’aide du corpus public de documentation.

Le point de terminaison `/support/docs-search` répond aux questions en s’appuyant sur la documentation publique de Firecrawl. Votre clé API Firecrawl est requise. Renvoie une réponse concise, fondée sur la documentation, avec des citations des pages pertinentes.

<div id="use-cases">
  ## Cas d’utilisation
</div>

* **Agents IA** qui doivent consulter l’utilisation de l’API Firecrawl, ses paramètres ou les bonnes pratiques
* **Bots d’assistance** qui répondent aux questions des clients à partir de la documentation
* **Outils de développement** qui affichent la documentation pertinente directement dans l’interface

<div id="example">
  ## Exemple
</div>

```bash theme={null}
curl -X POST https://api.firecrawl.dev/v2/support/docs-search \
  -H "Authorization: Bearer fc-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "what header carries the webhook signature, and how do I verify it?"
  }'
```

<div id="response">
  ### Réponse
</div>

```json theme={null}
{
  "requestId": "req_...",
  "answer": "The signature is sent in the X-Firecrawl-Signature header...",
  "evidence": [
    {
      "pathOrUrl": "webhooks/security.mdx#L1-L52",
      "reason": "Documents webhook signature verification"
    }
  ],
  "usage": { "inputTokens": 4356, "outputTokens": 688, "totalTokens": 5044 },
  "durationMs": 11252
}
```

<div id="response-fields">
  ## Champs de la réponse
</div>

| Champ        | Type    | Description                                                           |
| ------------ | ------- | --------------------------------------------------------------------- |
| `answer`     | string  | Réponse concise basée sur la documentation Firecrawl                  |
| `evidence`   | array   | Pages de documentation citées, avec `pathOrUrl` et `reason`           |
| `usage`      | object  | Consommation de jetons (`inputTokens`, `outputTokens`, `totalTokens`) |
| `durationMs` | integer | Durée totale d'exécution en millisecondes                             |

Pour consulter le guide complet de la fonctionnalité, voir la [documentation de la fonctionnalité Ask](/fr/features/ask).

> Ê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 les instructions d'intégration automatisée.


## OpenAPI

````yaml fr/api-reference/v2-openapi.json POST /support/docs-search
openapi: 3.0.0
info:
  contact:
    email: support@firecrawl.dev
    name: Firecrawl Support
    url: https://firecrawl.dev/support
  description: >-
    API pour interagir avec les services Firecrawl afin d’effectuer des tâches
    de scraping et de crawling web.
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /support/docs-search:
    post:
      tags:
        - Support
      summary: Rechercher dans la documentation Firecrawl avec citations
      description: >-
        Répondez aux questions sur la documentation Firecrawl à l’aide du corpus
        public de documentation.
      operationId: searchSupportDocs
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SupportDocsSearchRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportDocsSearchResponse'
          description: Réponse fondée sur la documentation
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: Requête non valide
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: Jeton Bearer manquant ou invalide
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: Agent de support indisponible
        '504':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: Délai d’attente de l’agent de support dépassé
      security:
        - bearerAuth: []
components:
  schemas:
    SupportDocsSearchRequest:
      properties:
        question:
          description: Question sur la documentation à laquelle répondre.
          type: string
      required:
        - question
      type: object
    SupportDocsSearchResponse:
      properties:
        answer:
          description: Réponse concise fondée sur la documentation de Firecrawl.
          type: string
        durationMs:
          description: >-
            Temps d’exécution total de la recherche dans la documentation, en
            millisecondes.
          type: integer
        evidence:
          items:
            properties:
              pathOrUrl:
                type: string
              reason:
                type: string
            type: object
          type: array
        requestId:
          type: string
        usage:
          properties:
            inputTokens:
              type: integer
            outputTokens:
              type: integer
            totalTokens:
              type: integer
          type: object
      type: object
    SupportProxyErrorResponse:
      properties:
        error:
          description: Code d’erreur du proxy de support ou du service amont.
          type: string
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````