Skip to main content
POST
Buscar y, opcionalmente, hacer scraping de los resultados de búsqueda
Nota: Ya está disponible una versión v2 de esta API con funciones y rendimiento mejorados.
El punto de conexión /search combina la búsqueda web con las capacidades de scraping de Firecrawl para devolver el contenido completo de la página para cualquier consulta. Incluye scrapeOptions con formats: ["markdown"] para obtener el contenido completo en Markdown de cada resultado de búsqueda; de lo contrario, de forma predeterminada recibirás los resultados (url, title, description).

Operadores de consulta compatibles

Ofrecemos una variedad de operadores de consulta que te permiten filtrar mejor tus búsquedas.

Parámetro de ubicación

Usa el parámetro location para obtener resultados de búsqueda con orientación geográfica. Formato: "string". Ejemplos: "Germany", "San Francisco,California,United States". Consulta la lista completa de ubicaciones admitidas para ver todos los países e idiomas disponibles. Usa el parámetro tbs para filtrar los resultados por periodos de tiempo, incluidos los rangos de fechas personalizados. Consulta la documentación de la función de búsqueda para ver ejemplos detallados y los formatos compatibles.

Autorizaciones

Authorization
string
header
requerido

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

Cuerpo

application/json
query
string
requerido

Consulta de búsqueda

ignoreInvalidURLs
boolean
predeterminado:false

Excluye de los resultados de búsqueda las URLs que no son válidas para otros endpoints de Firecrawl. Esto ayuda a reducir errores si canalizas datos de la búsqueda hacia otros endpoints de la API de Firecrawl.

limit
integer
predeterminado:5

Número máximo de resultados que se devolverán

Rango requerido: 1 <= x <= 100
location
string

Parámetro de ubicación para los resultados de búsqueda

scrapeOptions
object

Opciones para extraer resultados de búsqueda

tbs
string

Parámetro de búsqueda temporal. Admite intervalos de tiempo predefinidos (qdr:h, qdr:d, qdr:w, qdr:m, qdr:y) y rangos de fechas personalizados (cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY).

threatProtection
Threat Protection Override · object

Anulación por solicitud de Protección contra amenazas. Los campos que proporciones reemplazan los campos correspondientes de la política de tu organización solo para esta solicitud; los campos omitidos conservan sus valores a nivel de organización. Requiere que Protección contra amenazas esté habilitada para tu equipo (función Enterprise); de lo contrario, la solicitud se rechaza con un 403. Si tu organización ha deshabilitado las anulaciones por solicitud, cualquier solicitud que incluya este objeto se rechaza con un 403. Si Protección contra amenazas se aplica de forma obligatoria para tu equipo, mode no puede establecerse en off.

timeout
integer
predeterminado:60000

Tiempo de espera en milisegundos

Respuesta

Respuesta correcta

data
object[]
id
string

El ID de la tarea de búsqueda

success
boolean
warning
string | null

Mensaje de advertencia si ocurre algún problema