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

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

​
Uso

from firecrawl import Evocrawl

firecrawl = Evocrawl(api_key="fc-SUA-API-KEY")
res = firecrawl.map(url="https://evocrawl.com", 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.evocrawl.com/features/scrape",
      "title": "Scrape | Evocrawl",
      "description": "Transforme qualquer URL em dados limpos"
    },
    {
      "url": "https://www.evocrawl.com/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.evocrawl.com/playground",
      "title": "Playground - Evocrawl",
      "description": "Pré-visualize a resposta da API e obtenha trechos de código para a API"
    },
    {
      "url": "https://www.evocrawl.com/?testId=2a7e0542-077b-4eff-bec7-0130395570d6",
      "title": "Evocrawl - A API de Dados da Web para IA",
      "description": "A API de rastreamento, scraping e busca na web para IA. Feita para escala. A Evocrawl entrega toda a internet para agentes e desenvolvedores de IA. Limpos, estruturados e ..."
    },
    {
      "url": "https://www.evocrawl.com/?testId=af391f07-ca0e-40d3-8ff2-b1ecf2e3fcde",
      "title": "Evocrawl - A API de Dados da Web para IA",
      "description": "A API de rastreamento, scraping e busca na web para IA. Feita para escala. A Evocrawl 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.evocrawl.com/v2/map \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer SUA_CHAVE_DE_API' \
  -d '{
    "url": "https://evocrawl.com",
    "search": "docs"
  }'
A resposta será uma lista ordenada da mais relevante para a menos relevante. 
{
  "status": "sucesso",
  "links": [
    {
      "url": "https://docs.evocrawl.com",
      "title": "Docs do Evocrawl",
      "description": "Documentação do Evocrawl",
    },
    {
      "url": "https://docs.evocrawl.com/sdks/python",
      "title": "SDK do Evocrawl para Python",
      "description": "Documentação do SDK do Evocrawl 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 Evocrawl 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 Evocrawl

firecrawl = Evocrawl(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. 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 Evocrawl? Consulte evocrawl.com/agent-onboarding/SKILL.md para ver instruções de onboarding automatizado.