# Mapear (/es/api-reference/endpoint/map) Related: [Búsqueda](/es/api-reference/endpoint/search.md), [Comentarios sobre la búsqueda](/es/api-reference/endpoint/search-feedback.md), [Scrape](/es/api-reference/endpoint/scrape.md), [Raspado en lote](/es/api-reference/endpoint/batch-scrape.md), [Obtener el estado de la captura por lotes](/es/api-reference/endpoint/batch-scrape-get.md), [Cancelar extracción en lote](/es/api-reference/endpoint/batch-scrape-delete.md) > ¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para obtener instrucciones de incorporación automatizada. `POST /map` Mapear varias URL en función de las opciones ## OpenAPI ```json { "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "examples": { "example1": { "summary": "Ejemplo 1", "value": { "ignoreCache": false, "ignoreQueryParameters": true, "includeSubdomains": true, "limit": 5000, "location": { "country": "US", "languages": [ "en-US" ] }, "search": "", "sitemap": "include", "timeout": 60000, "url": "" } } }, "schema": { "properties": { "auditMetadata": { "additionalProperties": false, "description": "Atribución de usuario incluida en los eventos de registro SIEM cuando SIEM Logging está habilitado para la organización.", "properties": { "username": { "description": "El nombre de usuario asociado a la solicitud.", "maxLength": 1024, "type": "string" } }, "required": [ "username" ], "type": "object" }, "ignoreCache": { "default": false, "description": "Omitir la caché del sitemap para obtener URLs actualizadas. Los datos del sitemap se almacenan en caché hasta 7 días; usa este parámetro cuando tu sitemap se haya actualizado recientemente.", "type": "boolean" }, "ignoreQueryParameters": { "default": true, "description": "No devuelvas direcciones URL con parámetros de consulta", "type": "boolean" }, "includeSubdomains": { "default": true, "description": "Incluir subdominios del sitio web", "type": "boolean" }, "limit": { "default": 5000, "description": "Número máximo de enlaces que se devolverán", "maximum": 100000, "type": "integer" }, "location": { "description": "Configuración de ubicación de la solicitud. Cuando se especifica, se utilizará un proxy adecuado si está disponible y se emularán la configuración de idioma y la zona horaria correspondientes. De manera predeterminada se usa 'US' si no se especifica.", "properties": { "country": { "default": "US", "description": "Código de país ISO 3166-1 alfa-2 (p. ej., «US», «AU», «DE», «JP»)", "pattern": "^[A-Z]{2}$", "type": "string" }, "languages": { "description": "Idiomas y configuraciones regionales preferidos para la solicitud, en orden de prioridad. De forma predeterminada, se utiliza el idioma de la ubicación especificada. Consulta https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language", "items": { "example": "en-US", "type": "string" }, "type": "array" } }, "type": "object" }, "search": { "description": "Especifica una consulta de búsqueda para ordenar los resultados según su relevancia. Ejemplo: \"blog\" devolverá las URL que contengan la palabra \"blog\" en la URL, ordenadas por relevancia.", "type": "string" }, "sitemap": { "default": "include", "description": "Modo de uso del sitemap al mapear. Si lo configuras en `skip`, el sitemap no se usará para encontrar URL. Si lo configuras en `only`, solo se devolverán las URL que estén en el sitemap. De forma predeterminada (`include`), el sitemap y otros métodos se usarán conjuntamente para encontrar URL.", "enum": [ "skip", "include", "only" ], "type": "string" }, "threatProtection": { "description": "Anulación por solicitud de [Protección contra amenazas](https://docs.firecrawl.dev/features/threat-protection). Los campos que proporciones reemplazan los campos correspondientes de la política de tu organización solo para esta solicitud; los campos omitidos conservan sus valores a nivel de organización. Requiere que Protección contra amenazas esté habilitada para tu equipo (función enterprise); de lo contrario, la solicitud se rechaza con un 403. Si tu organización ha deshabilitado las anulaciones por solicitud, cualquier solicitud que incluya este objeto se rechaza con un 403. Si Protección contra amenazas se aplica de forma obligatoria a tu equipo, `mode` no puede establecerse en `off`.", "properties": { "blacklist": { "description": "Dominios que siempre se deben bloquear, como dominios simples (`example.com`) o patrones con comodines (`*.example.com`). Sin protocolo, ruta ni puerto.", "items": { "type": "string" }, "maxItems": 1000, "type": "array" }, "blockedTlds": { "description": "Dominios de nivel superior que se bloquean directamente, en minúsculas y sin el punto inicial (p. ej., `zip`).", "items": { "type": "string" }, "maxItems": 1000, "type": "array" }, "failurePolicy": { "description": "Qué hacer cuando no se puede acceder al clasificador: `closed` bloquea la solicitud; `open` la permite.", "enum": [ "open", "closed" ], "type": "string" }, "mode": { "description": "Modo de análisis de URL para esta solicitud. `normal` verifica las URL con Google Web Risk (+2 créditos por URL analizada).", "enum": [ "off", "normal" ], "type": "string" }, "riskScoreThreshold": { "description": "Puntuación de riesgo normalizada (0–100) a partir de la cual el veredicto de un clasificador bloquea la URL. Cuanto más bajo, más estricto.", "example": 75, "maximum": 100, "minimum": 0, "type": "integer" }, "whitelist": { "description": "Dominios que siempre se deben permitir, como dominios simples o patrones con comodines. Tiene prioridad sobre cualquier otra regla.", "items": { "type": "string" }, "maxItems": 1000, "type": "array" } }, "title": "Threat Protection Override", "type": "object" }, "timeout": { "description": "Tiempo de espera en milisegundos. De forma predeterminada, no hay tiempo de espera.", "type": "integer" }, "url": { "description": "La URL base desde la que comenzar el rastreo", "format": "uri", "type": "string" } }, "required": [ "url" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "links": { "items": { "properties": { "description": { "description": "Una descripción de la página, si está disponible.", "type": "string" }, "title": { "description": "El título de la página, si está disponible.", "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": "array" }, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Respuesta satisfactoria" }, "402": { "content": { "application/json": { "schema": { "properties": { "error": { "example": "Payment required to access this resource.", "type": "string" } }, "type": "object" } } }, "description": "Se requiere pago" }, "429": { "content": { "application/json": { "schema": { "properties": { "error": { "example": "Request rate limit exceeded. Please wait and try again later.", "type": "string" } }, "type": "object" } } }, "description": "Demasiadas solicitudes" }, "500": { "content": { "application/json": { "schema": { "properties": { "error": { "example": "An unexpected error occurred on the server.", "type": "string" } }, "type": "object" } } }, "description": "Error del servidor" } } } ```