> ## 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.

# Retour sur la recherche

> Envoyez un retour sur la qualité d’une tâche de recherche et contribuez à améliorer les résultats de recherche de Firecrawl.

Utilisez le retour sur la recherche après avoir utilisé un résultat `search` ou lorsqu’il ne s’avère pas utile. Le retour améliore la qualité des résultats et peut donner lieu au remboursement d’1 crédit pour le premier envoi de retour sur une tâche de recherche, sous réserve des limites de l’équipe.

<div id="example-request">
  ### Exemple de requête
</div>

```bash theme={null}
curl -X POST "https://api.firecrawl.dev/v2/search/550e8400-e29b-41d4-a716-446655440000/feedback" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rating": "good",
    "valuableSources": [
      {
        "url": "https://docs.firecrawl.dev/features/search",
        "reason": "Most up-to-date description of /search."
      }
    ],
    "missingContent": [
      {
        "topic": "Pricing for the search endpoint",
        "description": "No pricing tier table for /search specifically."
      }
    ],
    "querySuggestions": "Boost docs.firecrawl.dev for queries that mention Firecrawl"
  }'
```


## OpenAPI

````yaml fr/api-reference/v2-openapi.json POST /search/{jobId}/feedback
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:
  /search/{jobId}/feedback:
    post:
      tags:
        - Search
        - Feedback
      summary: Envoyer un retour sur une tâche de recherche
      operationId: submitSearchFeedback
      parameters:
        - description: ID de tâche de recherche renvoyé par /search.
          in: path
          name: jobId
          required: true
          schema:
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchFeedbackRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackResponse'
          description: Retour enregistré
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackErrorResponse'
          description: Corps de la requête invalide
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackErrorResponse'
          description: Le retour n’est pas disponible pour cette équipe
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackErrorResponse'
          description: Recherche introuvable pour cette équipe
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackErrorResponse'
          description: Le retour ne peut pas être enregistré pour cette recherche
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackErrorResponse'
          description: Erreur serveur
      security:
        - bearerAuth: []
components:
  schemas:
    SearchFeedbackRequest:
      description: "Pour «\_good\_», incluez valuableSources. Pour «\_partial\_», incluez valuableSources ou missingContent. Pour «\_bad\_», incluez missingContent ou querySuggestions."
      properties:
        integration:
          nullable: true
          type: string
        missingContent:
          items:
            properties:
              description:
                maxLength: 2000
                type: string
              topic:
                maxLength: 200
                minLength: 1
                type: string
            required:
              - topic
            type: object
          maxItems: 20
          type: array
        origin:
          default: api
          type: string
        querySuggestions:
          maxLength: 2000
          type: string
        rating:
          enum:
            - good
            - partial
            - bad
          type: string
        valuableSources:
          items:
            properties:
              reason:
                maxLength: 1000
                type: string
              url:
                format: uri
                type: string
            required:
              - url
            type: object
          maxItems: 50
          type: array
      required:
        - rating
      type: object
    FeedbackResponse:
      properties:
        alreadySubmitted:
          type: boolean
        creditsRefunded:
          type: number
        creditsRefundedToday:
          type: number
        dailyCapReached:
          type: boolean
        dailyRefundCap:
          type: number
        feedbackId:
          format: uuid
          type: string
        success:
          example: true
          type: boolean
        warning:
          type: string
      required:
        - success
        - feedbackId
        - creditsRefunded
      type: object
    FeedbackErrorResponse:
      properties:
        details:
          items:
            type: object
          type: array
        error:
          type: string
        feedbackErrorCode:
          type: string
        success:
          example: false
          type: boolean
      required:
        - success
        - error
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````