# Map (/pt-BR/api-reference/endpoint/map) Related: [Pesquisa](/pt-BR/api-reference/endpoint/search.md), [Feedback de busca](/pt-BR/api-reference/endpoint/search-feedback.md), [Raspar](/pt-BR/api-reference/endpoint/scrape.md), [Raspar em lote](/pt-BR/api-reference/endpoint/batch-scrape.md), [Obter status do scrape em lote](/pt-BR/api-reference/endpoint/batch-scrape-get.md), [Cancelar raspagem em lote](/pt-BR/api-reference/endpoint/batch-scrape-delete.md) > Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para obter instruções automatizadas de onboarding. `POST /map` Mapear várias URLs com base em opções ## OpenAPI ```json { "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "examples": { "example1": { "summary": "Exemplo 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": "Identificação do usuário incluída nos eventos de log do SIEM quando o SIEM Logging estiver habilitado para a organização.", "properties": { "username": { "description": "O nome de usuário associado à requisição.", "maxLength": 1024, "type": "string" } }, "required": [ "username" ], "type": "object" }, "ignoreCache": { "default": false, "description": "Ignora o cache do sitemap para obter URLs atualizadas. Os dados do sitemap ficam em cache por até 7 dias; use este parâmetro quando o seu sitemap tiver sido atualizado recentemente.", "type": "boolean" }, "ignoreQueryParameters": { "default": true, "description": "Não retorne URLs com parâmetros de query", "type": "boolean" }, "includeSubdomains": { "default": true, "description": "Incluir subdomínios do site", "type": "boolean" }, "limit": { "default": 5000, "description": "Número máximo de links retornados", "maximum": 100000, "type": "integer" }, "location": { "description": "Configurações de localização para a requisição. Quando especificadas, será usado um proxy apropriado, se disponível, e serão emulados o idioma e o fuso horário correspondentes. O padrão é 'US' caso não seja especificado.", "properties": { "country": { "default": "US", "description": "Código de país alfa-2 da ISO 3166-1 (por exemplo, 'US', 'AU', 'DE', 'JP')", "pattern": "^[A-Z]{2}$", "type": "string" }, "languages": { "description": "Idiomas e localidades preferenciais da requisição, em ordem de prioridade. Por padrão, usa o idioma da localidade especificada. Consulte https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language", "items": { "example": "en-US", "type": "string" }, "type": "array" } }, "type": "object" }, "search": { "description": "Especifique uma consulta de pesquisa para ordenar os resultados por relevância. Exemplo: \"blog\" retornará URLs que contenham a palavra \"blog\" na URL, ordenadas por relevância.", "type": "string" }, "sitemap": { "default": "include", "description": "Modo de uso do sitemap durante o mapeamento. Se você definir como `skip`, o sitemap não será usado para encontrar URLs. Se você definir como `only`, apenas URLs que estiverem no sitemap serão retornadas. Por padrão (`include`), o sitemap e outros métodos serão usados em conjunto para encontrar URLs.", "enum": [ "skip", "include", "only" ], "type": "string" }, "threatProtection": { "description": "Substituição por solicitação da [Proteção contra ameaças](https://docs.firecrawl.dev/features/threat-protection). Os campos fornecidos substituem os campos correspondentes da política da sua organização apenas nesta solicitação; os campos omitidos mantêm os valores definidos no nível da organização. Exige que a Proteção contra ameaças esteja habilitada para sua equipe (recurso enterprise) — caso contrário, a solicitação será rejeitada com 403. Se sua organização tiver desativado substituições por solicitação, qualquer solicitação que inclua este objeto será rejeitada com 403. Se a Proteção contra ameaças for imposta à sua equipe, `mode` não poderá ser definido como `off`.", "properties": { "blacklist": { "description": "Domínios a serem sempre bloqueados, como domínios simples (`example.com`) ou padrões curinga (`*.example.com`). Sem protocolo, caminho ou porta.", "items": { "type": "string" }, "maxItems": 1000, "type": "array" }, "blockedTlds": { "description": "Domínios de nível superior a serem bloqueados diretamente, em minúsculas e sem o ponto inicial (ex.: `zip`).", "items": { "type": "string" }, "maxItems": 1000, "type": "array" }, "failurePolicy": { "description": "O que fazer quando o classificador não puder ser acessado: `closed` bloqueia a solicitação, `open` a permite.", "enum": [ "open", "closed" ], "type": "string" }, "mode": { "description": "Modo de verificação de URL para esta solicitação. `normal` verifica as URLs no Google Web Risk (+2 créditos por URL verificada).", "enum": [ "off", "normal" ], "type": "string" }, "riskScoreThreshold": { "description": "Pontuação de risco normalizada (0–100) a partir da qual um veredito do classificador bloqueia a URL. Quanto menor, mais rigoroso.", "example": 75, "maximum": 100, "minimum": 0, "type": "integer" }, "whitelist": { "description": "Domínios a serem sempre permitidos, como domínios simples ou padrões curinga. Tem prioridade sobre todas as outras regras.", "items": { "type": "string" }, "maxItems": 1000, "type": "array" } }, "title": "Threat Protection Override", "type": "object" }, "timeout": { "description": "Tempo limite, em milissegundos. Não há tempo limite definido por padrão.", "type": "integer" }, "url": { "description": "URL base de onde o rastreamento será iniciado", "format": "uri", "type": "string" } }, "required": [ "url" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "links": { "items": { "properties": { "description": { "description": "Descrição da página, se disponível.", "type": "string" }, "title": { "description": "O título da página, se disponível.", "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": "array" }, "success": { "type": "boolean" } }, "type": "object" } } }, "description": "Resposta bem-sucedida" }, "402": { "content": { "application/json": { "schema": { "properties": { "error": { "example": "Payment required to access this resource.", "type": "string" } }, "type": "object" } } }, "description": "Pagamento obrigatório" }, "429": { "content": { "application/json": { "schema": { "properties": { "error": { "example": "Request rate limit exceeded. Please wait and try again later.", "type": "string" } }, "type": "object" } } }, "description": "Muitas requisições" }, "500": { "content": { "application/json": { "schema": { "properties": { "error": { "example": "An unexpected error occurred on the server.", "type": "string" } }, "type": "object" } } }, "description": "Erro do servidor" } } } ```