Skip to main content
POST
Pesquisar e, opcionalmente, raspar os resultados da busca
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 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 (url, title, description).

Operadores de consulta compatíveis

Oferecemos uma variedade de operadores de consulta que permitem filtrar melhor suas buscas.

Parâmetro de localização

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 locais compatíveis para ver todos os países e idiomas disponíveis. Use o parâmetro 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.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Corpo

application/json
query
string
obrigatório

A consulta de pesquisa

ignoreInvalidURLs
boolean
padrão:false

Exclui dos resultados de pesquisa as URLs que são inválidas para outros endpoints do Firecrawl. Isso ajuda a reduzir erros se você estiver encaminhando dados da pesquisa para outros endpoints da API do Firecrawl.

limit
integer
padrão:5

Número máximo de resultados a retornar

Intervalo obrigatório: 1 <= x <= 100
location
string

Parâmetro de localização para resultados de pesquisa

scrapeOptions
object

Opções para extrair resultados de busca

tbs
string

Parâmetro de pesquisa baseado em tempo. Suporta períodos de tempo predefinidos (qdr:h, qdr:d, qdr:w, qdr:m, qdr:y) e intervalos de datas personalizados (cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY)

threatProtection
Threat Protection Override · object

Substituição por solicitação da Proteção contra ameaças. Os campos fornecidos substituem os campos correspondentes da política da sua organização somente para esta solicitação; os campos omitidos mantêm os valores definidos no nível da organização. Exige que a Proteção contra ameaças esteja ativada para sua equipe (recurso enterprise) — caso contrário, a solicitação será rejeitada com 403. Se sua organização tiver desativado as substituições por solicitação, qualquer solicitação que inclua este objeto será rejeitada com 403. Se a Proteção contra ameaças for obrigatória para sua equipe, mode não poderá ser definido como off.

timeout
integer
padrão:60000

Tempo limite em milissegundos

Resposta

Resposta bem-sucedida

data
object[]
id
string

O ID da tarefa de busca

success
boolean
warning
string | null

Mensagem de aviso caso ocorra algum problema