Mapa | Firecrawl

Apresentando o /map

A forma mais simples de ir de uma única URL para um mapa de todo o site. Isso é extremamente útil para:

Quando você precisa pedir ao usuário final que escolha quais links devem ser coletados
Quando você precisa saber rapidamente quais links existem em um site
Quando você precisa coletar páginas de um site relacionadas a um tópico específico (use o parâmetro search)
Quando você só precisa coletar páginas específicas de um site

Experimente no Playground

Experimente o mapeamento no playground interativo — sem precisar escrever código.

Mapeamento

endpoint /map

Usado para mapear uma URL e obter as URLs do site. Retorna a maioria dos links presentes no site. As URLs são descobertas principalmente a partir do sitemap do site, complementadas com resultados de SERP (páginas de resultados de mecanismos de busca) e páginas rastreadas anteriormente para melhorar a cobertura. Você pode controlar o comportamento do sitemap com o parâmetro sitemap.

Instalação

# pip install firecrawl-py

from firecrawl import Firecrawl

firecrawl = Firecrawl(
  # Nenhuma API key necessária para começar — adicione uma para limites de taxa mais altos:
  # api_key="fc-YOUR-API-KEY",
)

// npm install firecrawl

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({
  // Nenhuma API key necessária para começar — adicione uma para limites de taxa maiores:
  // apiKey: "fc-YOUR-API-KEY",
});

# Instale globalmente com npm
npm install -g firecrawl

# Autentique (configuração única)
firecrawl login

Uso

from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key="fc-SUA-API-KEY")
res = firecrawl.map(url="https://firecrawl.dev", limit=50, sitemap="include")
print(res)

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: "fc-SUA-API-KEY" });

const res = await firecrawl.map('https://firecrawl.dev', { limit: 50, sitemap: 'include' });
console.log(res);

curl -X POST https://api.firecrawl.dev/v2/map \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer SUA_API_KEY' \
    -d '{
      "url": "https://firecrawl.dev"
    }'

# Mapeia um site para descobrir URLs
firecrawl map https://firecrawl.dev

# Output as JSON with limit
firecrawl map https://firecrawl.dev --json --limit 100 --pretty

Cada chamada de map consome 1 crédito por execução, independentemente do número de URLs retornadas. Por exemplo, definir limit como 100.000 ainda usa 1 crédito.

Resposta

Os SDKs retornarão o objeto de dados diretamente. O cURL retornará o payload exatamente como mostrado abaixo.

{
  "success": true,
  "links": [
    {
      "url": "https://docs.firecrawl.dev/features/scrape",
      "title": "Scrape | Firecrawl",
      "description": "Transforme qualquer URL em dados limpos"
    },
    {
      "url": "https://www.firecrawl.dev/blog/5_easy_ways_to_access_glm_4_5",
      "title": "5 Maneiras Fáceis de Acessar o GLM-4.5",
      "description": "Descubra como acessar os modelos GLM-4.5 localmente, por aplicativos de chat, via API oficial e usando a API de marketplaces de LLM para integração contínua..."
    },
    {
      "url": "https://www.firecrawl.dev/playground",
      "title": "Playground - Firecrawl",
      "description": "Pré-visualize a resposta da API e obtenha trechos de código para a API"
    },
    {
      "url": "https://www.firecrawl.dev/?testId=2a7e0542-077b-4eff-bec7-0130395570d6",
      "title": "Firecrawl - A API de Dados da Web para IA",
      "description": "A API de rastreamento, scraping e busca na web para IA. Feita para escala. A Firecrawl entrega toda a internet para agentes e desenvolvedores de IA. Limpos, estruturados e ..."
    },
    {
      "url": "https://www.firecrawl.dev/?testId=af391f07-ca0e-40d3-8ff2-b1ecf2e3fcde",
      "title": "Firecrawl - A API de Dados da Web para IA",
      "description": "A API de rastreamento, scraping e busca na web para IA. Feita para escala. A Firecrawl entrega toda a internet para agentes e desenvolvedores de IA. Limpos, estruturados e ..."
    },
    ...
  ]
}

Título e descrição nem sempre estão presentes, pois depende do site.

Mapear com busca

Usar o parâmetro search no Map permite procurar URLs específicas dentro de um site.

cURL

curl -X POST https://api.firecrawl.dev/v2/map \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer SUA_CHAVE_DE_API' \
  -d '{
    "url": "https://firecrawl.dev",
    "search": "docs"
  }'

A resposta será uma lista ordenada da mais relevante para a menos relevante.

{
  "status": "sucesso",
  "links": [
    {
      "url": "https://docs.firecrawl.dev",
      "title": "Docs do Firecrawl",
      "description": "Documentação do Firecrawl",
    },
    {
      "url": "https://docs.firecrawl.dev/sdks/python",
      "title": "SDK do Firecrawl para Python",
      "description": "Documentação do SDK do Firecrawl para Python"
    },
    ...
  ]
}

Localização e idioma

Especifique o país e os idiomas preferidos para obter conteúdo relevante com base no seu local de destino e nas preferências de idioma, de forma semelhante ao endpoint /scrape.

Como funciona

Ao definir as configurações de localização, o Firecrawl usará um proxy apropriado, se disponível, e emulará o idioma e o fuso horário correspondentes. Por padrão, a localização é definida como “US” se nada for especificado.

Uso

Para usar as configurações de localização e idioma, inclua o objeto location no corpo da requisição com as seguintes propriedades:

country: código de país ISO 3166-1 alfa-2 (por exemplo, ‘US’, ‘AU’, ‘DE’, ‘JP’). Padrão: ‘US’.
languages: um array de idiomas e localidades preferenciais para a requisição, em ordem de prioridade. Padrão: o idioma da localização especificada.

from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")

res = firecrawl.map('https://example.com',
    location={
        'country': 'US',
        'languages': ['en']
    }
)

print(res)

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: "fc-SUA-API-KEY" });

const res = await firecrawl.map('https://example.com', {
  location: { country: 'US', languages: ['en'] },
});

console.log(res.metadata);

curl -X POST "https://api.firecrawl.dev/v2/map" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "location": { "country": "US", "languages": ["en"] }
  }'

Para mais detalhes sobre as localizações compatíveis, consulte a documentação de Proxies.

Considerações

Este endpoint prioriza a velocidade, portanto, talvez não capture todos os links do site. Ele se baseia principalmente no sitemap do site, complementado por dados de rastreamento em cache e resultados de mecanismos de busca. Para obter uma lista de URLs mais completa e atualizada, considere usar o endpoint /crawl.

Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte firecrawl.dev/agent-onboarding/SKILL.md para ver instruções de onboarding automatizado.

​Apresentando o /map

Experimente no Playground

​Mapeamento

​endpoint /map

​Instalação

​Uso

​Resposta

​Mapear com busca

​Localização e idioma

​Como funciona

​Uso

​Considerações

Apresentando o /map

Mapeamento

endpoint /map

Instalação

Uso

Resposta

Mapear com busca

Localização e idioma

Como funciona

Uso

Considerações