Observação: Uma nova versão v2 desta API está disponível, com recursos e desempenho aprimorados.O endpoint /search combina a busca na web (SERP) com os recursos de scraping do Firecrawl para retornar o conteúdo completo da página para qualquer consulta. Inclua
scrapeOptions
com formats: ["markdown"]
para obter o conteúdo completo em Markdown para cada resultado de busca; caso contrário, por padrão você receberá apenas os resultados do SERP (url, title, description).
Operadores de consulta compatíveis
Operador | Funcionalidade | Exemplos |
---|---|---|
"" | Faz correspondência exata (não difusa) com um trecho de texto | "Firecrawl" |
- | Exclui determinadas palavras-chave ou nega outros operadores | -bad , -site:firecrawl.dev |
site: | Retorna apenas resultados de um site específico | site:firecrawl.dev |
inurl: | Retorna apenas resultados que incluem uma palavra na URL | inurl:firecrawl |
allinurl: | Retorna apenas resultados que incluem várias palavras na URL | allinurl:git firecrawl |
intitle: | Retorna apenas resultados que incluem uma palavra no título da página | intitle:Firecrawl |
allintitle: | Retorna apenas resultados que incluem várias palavras no título da página | allintitle:firecrawl playground |
related: | Retorna apenas resultados relacionados a um domínio específico | related:firecrawl.dev |
Parâmetro de localização
location
para obter resultados de pesquisa segmentados por região. Formato: "string"
. Exemplos: "Germany"
, "San Francisco,California,United States"
.
Consulte a lista completa de locais compatíveis para ver todos os países e idiomas disponíveis.
Pesquisa por período
tbs
para filtrar os resultados por períodos, incluindo intervalos de datas personalizados. Consulte a documentação do recurso de busca para exemplos detalhados e formatos compatíveis.Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
The search query
Maximum number of results to return
Required range:
1 <= x <= 100
Time-based search parameter. Supports predefined time ranges (qdr:h
, qdr:d
, qdr:w
, qdr:m
, qdr:y
) and custom date ranges (cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY
)
Location parameter for search results
Timeout in milliseconds
Excludes URLs from the search results that are invalid for other Firecrawl endpoints. This helps reduce errors if you are piping data from search into other Firecrawl API endpoints.
Options for scraping search results