/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 pesquisa
categories:
github: Pesquise em repositórios do GitHub, código, issues e documentaçãoresearch: Pesquise em sites acadêmicos e de pesquisa (arXiv, Nature, IEEE, PubMed, etc.)pdf: Pesquise por PDFs
Pesquisa por categoria no GitHub
cURL
Pesquisa por categoria de pesquisa
cURL
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
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 cobre a parte da busca, enquanto zeroDataRetention em scrapeOptions cobre a parte do scraping. Para obter ZDR completo em ambos, defina os dois:
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
- Enhanced proxy mode: 4 créditos adicionais por página da web
- JSON mode: 4 créditos adicionais por página da web
- Defina
parsers: []se a análise de PDF não for necessária - Use
proxy: "basic"em vez de"enhanced"quando possível, ou defina como"auto" - 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.
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.
