Pular para o conteúdo principal

​
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.

​
Instalação

# pip install firecrawl-py

from firecrawl import Firecrawl

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

​
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)
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.
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)
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. Estamos trabalhando em melhorias. Feedback e sugestões são muito bem-vindos.