# Aperçu des paramètres de crawling (/fr/api-reference/endpoint/crawl-params-preview)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1430 · 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)



`POST /crawl/params-preview`

Prévisualiser les paramètres de crawl générés à partir d'une invite en langage naturel

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "prompt": {
              "description": "Invite en langage naturel décrivant ce que vous souhaitez crawler",
              "maxLength": 10000,
              "type": "string"
            },
            "url": {
              "description": "L’URL à explorer",
              "format": "uri",
              "type": "string"
            }
          },
          "required": [
            "url",
            "prompt"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "data": {
                "properties": {
                  "allowExternalLinks": {
                    "description": "Autoriser les liens externes",
                    "type": "boolean"
                  },
                  "allowSubdomains": {
                    "description": "Détermine s’il faut autoriser les sous-domaines",
                    "type": "boolean"
                  },
                  "crawlEntireDomain": {
                    "description": "Indique s’il faut explorer tout le domaine",
                    "type": "boolean"
                  },
                  "deduplicateSimilarURLs": {
                    "description": "Détermine s’il faut dédupliquer les URL similaires",
                    "type": "boolean"
                  },
                  "delay": {
                    "description": "Intervalle entre les requêtes, en millisecondes",
                    "type": "number"
                  },
                  "excludePaths": {
                    "description": "Motifs d’URL à exclure",
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "ignoreQueryParameters": {
                    "description": "Indique si les paramètres de requête doivent être ignorés",
                    "type": "boolean"
                  },
                  "ignoreRobotsTxt": {
                    "description": "Indique si les règles robots.txt sont ignorées",
                    "type": "boolean"
                  },
                  "includePaths": {
                    "description": "Motifs d’URL à inclure",
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "limit": {
                    "description": "Nombre maximal de pages à explorer",
                    "type": "integer"
                  },
                  "maxDepth": {
                    "description": "Profondeur maximale de crawl",
                    "type": "integer"
                  },
                  "maxDiscoveryDepth": {
                    "description": "Profondeur maximale d’exploration",
                    "type": "integer"
                  },
                  "robotsUserAgent": {
                    "description": "Chaîne User-Agent personnalisée utilisée pour l’évaluation de robots.txt",
                    "type": "string"
                  },
                  "sitemap": {
                    "description": "Stratégie de traitement du sitemap",
                    "enum": [
                      "skip",
                      "include"
                    ],
                    "type": "string"
                  },
                  "url": {
                    "description": "L’URL à explorer",
                    "format": "uri",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "success": {
                "example": true,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Réponse réussie contenant les paramètres de crawl générés"
    },
    "400": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Invalid request parameters",
                "type": "string"
              },
              "success": {
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Requête incorrecte"
    },
    "401": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Unauthorized",
                "type": "string"
              },
              "success": {
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Non autorisé"
    },
    "500": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Failed to process natural language prompt",
                "type": "string"
              },
              "success": {
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Erreur du serveur"
    }
  }
}
```