Pesquisa

O endpoint de pesquisa combina pesquisa na web com as capacidades de scraping do Firecrawl para retornar o conteúdo completo da página para qualquer consulta.

Inclua scrapeOptions com formats: [{"type": "markdown"}] para obter o conteúdo completo em markdown para cada resultado de pesquisa; caso contrário, você receberá por padrão apenas os resultados (url, title, description). Você também pode usar outros formatos, como {"type": "summary"} para conteúdo condensado.

Oferecemos uma variedade de operadores de pesquisa que ajudam você a filtrar melhor seus resultados.

Use o parâmetro location para obter resultados de pesquisa segmentados por região. Formato: "string". Exemplos: "Germany", "San Francisco,California,United States".

Consulte a lista completa de localidades compatíveis para ver todos os países e idiomas disponíveis.

Use o parâmetro country para definir o país dos resultados de pesquisa usando códigos de país ISO. Padrão: "US".

Exemplos: "US", "DE", "FR", "JP", "UK", "CA".

{
  "query": "restaurantes",
  "country": "DE"
}

Filtre os resultados de pesquisa por categorias específicas usando o parâmetro categories:

• github: Pesquise em repositórios do GitHub, código, issues e documentação
• research: Pesquise em sites acadêmicos e de pesquisa (arXiv, Nature, IEEE, PubMed, etc.)
• pdf: Pesquise por PDFs

{
  "query": "machine learning",
  "categories": ["github", "pesquisa"],
  "limit": 10
}

Use includeDomains para restringir os resultados a domínios específicos ou excludeDomains para excluir domínios específicos da busca. Os domínios devem conter apenas nomes de host, sem protocolo ou caminho.

includeDomains e excludeDomains são mutuamente excludentes.

{
  "query": "web scraping",
  "includeDomains": ["firecrawl.dev", "docs.firecrawl.dev"],
  "limit": 10
}

{
  "query": "web scraping tools",
  "excludeDomains": ["example.com"],
  "limit": 10
}

Cada resultado inclui um campo category que indica sua origem:

{
  "success": true,
  "data": {
    "web": [
      {
        "url": "https://github.com/example/ml-project",
        "title": "Machine Learning Project",
        "description": "Implementation of ML algorithms",
        "category": "github"
      },
      {
        "url": "https://arxiv.org/abs/2024.12345",
        "title": "ML Research Paper",
        "description": "Latest advances in machine learning",
        "category": "research"
      }
    ]
  }
}

Use o parâmetro tbs para filtrar resultados por períodos de tempo, incluindo intervalos de datas personalizados. Consulte a documentação do recurso de busca para exemplos detalhados e formatos suportados.

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