> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-noaa-mar-989-create-firecrawl-codex-plugins.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Recherche dans la 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:
  title: Firecrawl API
  version: v2
  description: >-
    API pour interagir avec les services Firecrawl afin d’effectuer des tâches
    de scraping et de crawling web.
  contact:
    name: Firecrawl Support
    url: https://firecrawl.dev/support
    email: support@firecrawl.dev
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /support/docs-search:
    post:
      tags:
        - Support
      summary: Rechercher dans la documentation Firecrawl à l’aide de l’IA
      operationId: supportDocsSearch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - question
              properties:
                question:
                  type: string
                  minLength: 1
                  maxLength: 8000
                  description: >-
                    La question à traiter à partir de la documentation publique
                    de Firecrawl.
      responses:
        '200':
          description: Réponse fondée sur la documentation renvoyée avec succès.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocsSearchResponse'
        '400':
          description: JSON invalide ou violation du schéma
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      security:
        - bearerAuth: []
components:
  schemas:
    DocsSearchResponse:
      type: object
      properties:
        requestId:
          type: string
          description: Identifiant unique de cette requête.
        answer:
          type: string
          description: Réponse concise fondée sur la documentation publique de Firecrawl.
        evidence:
          type: array
          description: Pages de documentation citées dans la réponse.
          items:
            type: object
            properties:
              pathOrUrl:
                type: string
              reason:
                type: string
        usage:
          type: object
          properties:
            inputTokens:
              type: integer
            outputTokens:
              type: integer
            totalTokens:
              type: integer
        durationMs:
          type: integer
          description: Temps d’exécution total en millisecondes.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````