# Recherche dans la documentation (/fr/api-reference/endpoint/docs-search)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1551 · updated: 2026-07-30 -->
Related: [Recherche](/fr/api-reference/endpoint/search.md), [Retour sur la recherche](/fr/api-reference/endpoint/search-feedback.md), [Scrape](/fr/api-reference/endpoint/scrape.md), [Scrape par lot](/fr/api-reference/endpoint/batch-scrape.md), [Obtenir l’état d’une extraction par lot](/fr/api-reference/endpoint/batch-scrape-get.md), [Annuler une extraction par lots](/fr/api-reference/endpoint/batch-scrape-delete.md)

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 [#cas-dutilisation]
</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 [#exemple]
</div>

```bash
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 [#réponse]
</div>

```json
{
  "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 [#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.

`POST /support/docs-search`

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

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "question": {
              "description": "Question sur la documentation à laquelle répondre.",
              "type": "string"
            }
          },
          "required": [
            "question"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "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"
          }
        }
      },
      "description": "Réponse fondée sur la documentation"
    },
    "400": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "description": "Code d’erreur du proxy de support ou du service amont.",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Requête non valide"
    },
    "401": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "description": "Code d’erreur du proxy de support ou du service amont.",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Jeton Bearer manquant ou invalide"
    },
    "503": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "description": "Code d’erreur du proxy de support ou du service amont.",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Agent de support indisponible"
    },
    "504": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "description": "Code d’erreur du proxy de support ou du service amont.",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Délai d’attente de l’agent de support dépassé"
    }
  }
}
```