> ## 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. # Mapear > ¿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. ## OpenAPI ````yaml es/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 para interactuar con los servicios de Firecrawl y realizar tareas de scraping y rastreo web. title: Firecrawl API version: v2 servers: - url: https://api.firecrawl.dev/v2 security: - bearerAuth: [] paths: /map: post: tags: - Mapping summary: Mapear varias URL en función de las opciones operationId: mapUrls 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: 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: $ref: '#/components/schemas/ThreatProtectionOverride' 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: $ref: '#/components/schemas/MapResponse' 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 security: - bearerAuth: [] components: schemas: ThreatProtectionOverride: 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 MapResponse: 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 securitySchemes: bearerAuth: scheme: bearer type: http ````