/search e o Firecrawl retorna títulos, descrições e URLs. Adicione scrapeOptions para também recuperar, para cada resultado, o markdown, HTML, links ou capturas de tela da página completa.
Os resultados de busca incluem Highlights relevantes para a consulta por padrão. Defina highlights como false quando quiser a descrição simples ou o snippet de cada site.
Para a lista completa de parâmetros, consulte a Referência da API do endpoint /search.
Experimente no Playground
Teste buscas no Playground interativo — sem precisar de código.
Fazendo uma pesquisa com o Firecrawl
endpoint /search
Instalação
Uso básico
Resposta
JSON
Usuários de SDKs: os resultados de busca são agrupados por tipo de origem, não em um array genérico
.data. Acesse os resultados da web com result.web, os de notícias com result.news e os de imagens com result.images.Python
JavaScript
Tipos de resultados de busca
sources:
web: resultados da web padrão (padrão)news: resultados focados em notíciasimages: resultados de busca de imagens
sources: ["web", "news"]). Quando fizer isso, o parâmetro limit é aplicado por tipo de fonte — assim, limit: 5 com sources: ["web", "news"] retorna até 5 resultados da web e até 5 resultados de notícias (10 no total). Se você precisar de parâmetros diferentes por fonte (por exemplo, valores diferentes de limit ou scrapeOptions diferentes), faça chamadas separadas.
Categorias de busca
categories:
research: restringe a busca na web a sites acadêmicos e de pesquisa (arxiv.org, nature.com, pubmed.ncbi.nlm.nih.gov e similares). Muda em 2026-11-16 para buscar no Research Index e retornar registros de artigos; veja o aviso abaixopdf: busca por PDFsdeveloper: busca no índice para desenvolvedores — issues, pull requests mesclados e READMEs de repositórios de código públicos, além de sites de documentação curados
Pesquisa por categoria de pesquisa
cURL
cURL
Busca na categoria Developer
cURL
web, cada um com category: "developer"; a categoria developer não pode ser combinada com outras categorias. Para obter resultados ranqueados com as passagens correspondentes e usar os filtros de repositório e fonte de documentação, use o endpoint de busca para desenvolvedores.
Pesquisa com categorias mistas
cURL
Filtros de domínio
includeDomains para restringir os resultados da busca a domínios específicos ou excludeDomains para remover domínios específicos da busca. Esses campos adicionam internamente os operadores site: e -site: à consulta, então informe apenas os domínios, sem protocolo nem caminho.
includeDomains e excludeDomains são mutuamente exclusivos. Use um ou outro em uma única requisição.Incluir domínios
cURL
Domínios a excluir
cURL
Formato de resposta de categoria
category indicando sua fonte:
cURL
cURL
Pesquisa de imagens em alta definição com filtro por tamanho
cURL
cURL
imagesize:1920x1080- Full HD (1080p)imagesize:2560x1440- QHD (1440p)imagesize:3840x2160- 4K UHDlarger:1920x1080- HD ou superiorlarger:2560x1440- QHD ou superior
Busca com Coleta de Conteúdo
scrapeOptions.
Resposta com conteúdo extraído
Buscar e depois fazer scraping (padrão de duas etapas)
Opções avançadas de busca
Personalização de localização
Busca por período
tbs para filtrar resultados por período. Observe que tbs se aplica apenas a resultados da fonte web — ele não filtra resultados de news ou images. Se você precisar de notícias com filtro de tempo, considere usar a fonte web com o operador site: para direcionar domínios de notícias específicos.
tbs:
qdr:h- Última horaqdr:d- Últimas 24 horasqdr:w- Última semanaqdr:m- Último mêsqdr:y- Último anosbd:1- Ordenar por data (mais recentes primeiro)
sbd:1 com filtros de tempo para obter resultados ordenados por data dentro de um intervalo de tempo. Por exemplo, sbd:1,qdr:w retorna resultados da última semana ordenados do mais recente para o mais antigo, e sbd:1,cdr:1,cd_min:12/1/2024,cd_max:12/31/2024 retorna resultados de dezembro de 2024 ordenados por data.
Tempo limite personalizado
Busca Segura
safe como true para filtrar conteúdo explícito dos resultados de busca (SafeSearch). Quando omitido, os resultados são retornados sem filtragem, como antes.
cURL
Zero Data Retention (ZDR)
/search por meio do parâmetro enterprise. A busca com ZDR está disponível nos planos Enterprise — visite firecrawl.dev/enterprise para começar.
Isso é diferente da opção de scraping
zeroDataRetention, que controla o ZDR para operações de scraping. Consulte Scrape ZDR para mais detalhes. O parâmetro enterprise se aplica apenas à parte de busca da requisição.ZDR de ponta a ponta
- Custo: 10 créditos por 10 resultados
- Parâmetro:
enterprise: ["zdr"]
cURL
ZDR anonimizado
- Custo: 2 créditos por 10 resultados
- Parâmetro:
enterprise: ["anon"]
cURL
Combinando ZDR de busca com ZDR de scraping
scrapeOptions), o parâmetro enterprise aplica automaticamente ZDR a todos os scrapes resultantes. O exemplo de solicitação a seguir aplica ZDR às partes de busca e scraping do processo:
cURL
Implicações de custos
- Basic scrape: 1 crédito por página da web
- PDF parsing: 1 crédito por página de PDF
- JSON mode: 4 créditos adicionais por página da web
- Defina
parsers: []se a análise de PDF não for necessária - Limite o número de resultados de busca com o parâmetro
limit
Opções avançadas de scraping
Você é um agente de IA que precisa de uma chave de API da Firecrawl? Consulte firecrawl.dev/agent-onboarding/SKILL.md para obter instruções de onboarding automatizado.
Desempenho medido
Estas são medições de terceiros, cada uma com seu próprio harness, conjunto de tarefas e metodologia — não são diretamente comparáveis entre si nem com os benchmarks do próprio Firecrawl. Estimativa pontual de 2º lugar entre 8; o teste de bootstrap pareado não apontou diferença estatisticamente significativa em relação a Brave, Exa ou Parallel Search Pro. As páginas de benchmark próprias do Firecrawl, incluindo a avaliação de código aberto do índice para desenvolvedores, estão em firecrawl.dev/benchmarks.
Feedback sobre busca
POST /v2/search/{jobId}/feedback. O primeiro envio de feedback para um job de busca pode reembolsar 1 crédito, sujeito aos limites da equipe, e ajuda a melhorar a qualidade da busca do Firecrawl. Consulte Feedback sobre busca.
