> ## 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 > 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. ## OpenAPI ````yaml pt-BR/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 interagir com os serviços do Firecrawl e executar tarefas de web scraping e crawling. title: Firecrawl API version: v2 servers: - url: https://api.firecrawl.dev/v2 security: - bearerAuth: [] paths: /map: post: tags: - Mapping summary: Mapear várias URLs com base em opções operationId: mapUrls 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: 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: $ref: '#/components/schemas/ThreatProtectionOverride' 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: $ref: '#/components/schemas/MapResponse' 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 security: - bearerAuth: [] components: schemas: ThreatProtectionOverride: 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 MapResponse: 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 securitySchemes: bearerAuth: scheme: bearer type: http ````