> ## 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. # Map > Êtes-vous un agent IA qui a besoin d’une clé API Firecrawl ? Consultez [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) pour obtenir des instructions d’intégration automatisée. ## OpenAPI ````yaml fr/api-reference/v2-openapi.json POST /map 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: /map: post: tags: - Mapping summary: Mapper plusieurs URL en fonction des options operationId: mapUrls requestBody: content: application/json: examples: example1: summary: "Exemple\_1" value: ignoreCache: false ignoreQueryParameters: true includeSubdomains: true limit: 5000 location: country: US languages: - en-US search: sitemap: include timeout: 60000 url: schema: properties: ignoreCache: default: false description: "Ignorez le cache du sitemap pour récupérer les URL les plus récentes. Les données du sitemap sont mises en cache pendant 7\_jours\_; utilisez ce paramètre lorsque votre sitemap a été mis à jour récemment." type: boolean ignoreQueryParameters: default: true description: Ne renvoyez pas d’URL contenant des paramètres de requête type: boolean includeSubdomains: default: true description: Inclure les sous-domaines du site type: boolean limit: default: 5000 description: Nombre maximal de liens à retourner maximum: 100000 type: integer location: description: >- Paramètres de localisation de la requête. Lorsqu’ils sont spécifiés, un proxy approprié est utilisé, si disponible, et les paramètres de langue et de fuseau horaire correspondants sont émulés. La valeur par défaut est « US » si aucun paramètre n’est spécifié. properties: country: default: US description: >- Code de pays ISO 3166-1 alpha-2 (par exemple « US », « AU », « DE », « JP ») pattern: ^[A-Z]{2}$ type: string languages: description: >- Langues et paramètres régionaux préférés pour la requête, par ordre de priorité. Par défaut, la langue de l’emplacement spécifié est utilisée. Voir https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language items: example: en-US type: string type: array type: object search: description: "Spécifiez une requête de recherche pour classer les résultats par pertinence. Exemple\_: «\_blog\_» renverra les URL qui contiennent le mot «\_blog\_» dans leur adresse, classées par pertinence." type: string sitemap: default: include description: >- Mode sitemap lors du mapping. Si vous le réglez sur `skip`, le sitemap ne sera pas utilisé pour trouver des URL. Si vous le réglez sur `only`, seules les URL présentes dans le sitemap seront renvoyées. Par défaut (`include`), le sitemap et d’autres méthodes sont utilisés conjointement pour trouver des URL. enum: - skip - include - only type: string threatProtection: $ref: '#/components/schemas/ThreatProtectionOverride' timeout: description: >- Délai d’attente en millisecondes. Aucun délai d’attente n’est appliqué par défaut. type: integer url: description: L’URL de base à partir de laquelle démarrer le crawl format: uri type: string required: - url type: object required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/MapResponse' description: Réponse réussie '402': content: application/json: schema: properties: error: example: Payment required to access this resource. type: string type: object description: Paiement requis '429': content: application/json: schema: properties: error: example: >- Request rate limit exceeded. Please wait and try again later. type: string type: object description: Trop de requêtes '500': content: application/json: schema: properties: error: example: An unexpected error occurred on the server. type: string type: object description: Erreur du serveur security: - bearerAuth: [] components: schemas: ThreatProtectionOverride: description: >- Dérogation [Protection contre les menaces](https://docs.firecrawl.dev/features/threat-protection) au niveau de la requête. Les champs que vous fournissez remplacent les champs correspondants de la politique de votre organisation pour cette requête uniquement ; les champs omis conservent leurs valeurs définies au niveau de l'organisation. La Protection contre les menaces doit être activée pour votre équipe (fonctionnalité Enterprise) ; sinon, la requête est rejetée avec un code 403. Si votre organisation a désactivé les dérogations par requête, toute requête qui inclut cet objet est rejetée avec un code 403. Si la Protection contre les menaces est appliquée à votre équipe, `mode` ne peut pas être défini sur `off`. properties: blacklist: description: >- Domaines à toujours bloquer, sous forme de domaines simples (`example.com`) ou de motifs avec joker (`*.example.com`). Sans protocole, chemin ni port. items: type: string maxItems: 1000 type: array blockedTlds: description: >- Domaines de premier niveau à bloquer systématiquement, en minuscules et sans le point initial (par ex. `zip`). items: type: string maxItems: 1000 type: array failurePolicy: description: >- Comportement à adopter lorsque le classifieur est injoignable : `closed` bloque la requête, `open` l'autorise. enum: - open - closed type: string mode: description: >- Mode d’analyse des URL pour cette requête. `normal` vérifie les URL via Google Web Risk (+2 crédits par URL analysée). enum: - 'off' - normal type: string riskScoreThreshold: description: >- Score de risque normalisé (0–100) à partir duquel une décision du classifieur bloque l’URL. Plus il est faible, plus le filtrage est strict. example: 75 maximum: 100 minimum: 0 type: integer whitelist: description: >- Domaines à toujours autoriser, sous forme de domaines simples ou de motifs avec joker. Prend le pas sur toutes les autres règles. items: type: string maxItems: 1000 type: array title: Threat Protection Override type: object MapResponse: properties: links: items: properties: description: description: Description de la page, le cas échéant. type: string title: description: Le titre de la page, le cas échéant. type: string url: format: uri type: string required: - url type: object type: array success: type: boolean type: object securitySchemes: bearerAuth: scheme: bearer type: http ````