Skip to main content
POST
Buscar y, opcionalmente, scrapear los resultados de búsqueda
El endpoint de búsqueda 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: [{"type": "markdown"}] para obtener el contenido completo en markdown de cada resultado de búsqueda; de lo contrario, por defecto solo obtendrás los resultados (url, title, description). También puedes usar otros formatos como {"type": "summary"} para obtener contenido condensado.

Operadores de consulta admitidos

Admitimos 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 geodirigidos. Formato: "string". Ejemplos: "Germany", "San Francisco,California,United States". Consulta la lista completa de ubicaciones compatibles para ver todos los países e idiomas disponibles.

Parámetro country

Usa el parámetro country para especificar el país de los resultados de búsqueda usando códigos de país ISO. Valor predeterminado: "US". Ejemplos: "US", "DE", "FR", "JP", "UK", "CA".

Parámetro categories

Filtra los resultados de búsqueda por categorías específicas usando el parámetro categories:
  • github: Busca en repositorios de GitHub, código, issues y documentación
  • research: Busca en sitios web académicos y de investigación (arXiv, Nature, IEEE, PubMed, etc.)
  • pdf: Busca archivos PDF

Ejemplo de uso

Filtros de dominio

Usa includeDomains para limitar los resultados a dominios específicos, o excludeDomains para excluir dominios específicos de la búsqueda. Los dominios deben ser únicamente nombres de host, sin protocolo ni ruta. includeDomains y excludeDomains son mutuamente excluyentes.

Ejemplo de inclusión de dominios

Ejemplo de exclusión de dominios

Respuesta de categoría

Cada resultado incluye un campo category que indica su origen:
Usa el parámetro tbs para filtrar los resultados por períodos de tiempo, incluidos rangos de fechas personalizados. Consulta la documentación de la funcionalidad de búsqueda para ver ejemplos detallados y formatos compatibles.
¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para obtener instrucciones para la incorporación automatizada.

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

Maximum string length: 500
categories
(GitHub · object | Research · object | PDF · object)[]

Categorías por las que filtrar los resultados. De forma predeterminada se establece en [], lo que significa que los resultados no se filtrarán por ninguna categoría.

country
string
predeterminado:US

Código de país ISO para la segmentación geográfica de los resultados de búsqueda (por ejemplo, US). Para obtener mejores resultados, establece tanto este parámetro como el parámetro location.

enterprise
enum<string>[]

Opciones de search para Enterprise con Zero Data Retention (ZDR). Usa ["zdr"] para ZDR de extremo a extremo (10 credits / 10 resultados) o ["anon"] para ZDR anonimizado (2 credits / 10 resultados). Debe estar habilitado para tu equipo.

Opciones disponibles:
anon,
zdr
excludeDomains
string<hostname>[]

Excluye los resultados de búsqueda de los dominios especificados. Los dominios deben ser únicamente nombres de host, sin protocolo ni ruta. No se puede usar con includeDomains.

highlights
boolean
predeterminado:true

Genera highlights relevantes para la query en los resultados de búsqueda. Establécelo en false para devolver descripciones o fragmentos del proveedor sin resaltado.

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 estás enviando datos desde la búsqueda a otros endpoints de la API de Firecrawl.

includeDomains
string<hostname>[]

Restringe los resultados de búsqueda a los dominios especificados. Los dominios deben ser únicamente nombres de host, sin protocolo ni ruta. No se puede usar con excludeDomains.

limit
integer
predeterminado:10

Número máximo de resultados que se devolverán (por tipo de fuente cuando se utilizan varias fuentes)

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

Parámetro de ubicación para los resultados de la búsqueda (por ejemplo, San Francisco,California,United States). Para obtener mejores resultados, configura tanto este parámetro como el parámetro country.

scrapeOptions
object

Opciones para scrapear resultados de búsqueda

sources
(Web · object | Images · object | News · object)[]

Fuentes en las que buscar. Determinarán los arrays disponibles en la respuesta. Por defecto es ['web'].

tbs
string

Parámetro de búsqueda por tiempo. Admite rangos de tiempo predefinidos (qdr:h, qdr:d, qdr:w, qdr:m, qdr:y), rangos de fechas personalizados (cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY) y ordenación por fecha (sbd:1). Los valores se pueden combinar, p. ej. sbd:1,qdr:w.

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 a tu equipo, mode no puede establecerse en off.

timeout
integer
predeterminado:60000

Tiempo de espera en milisegundos

Respuesta

Respuesta satisfactoria

creditsUsed
integer

El número de créditos consumidos en la búsqueda

data
object

Los resultados de la búsqueda. Los arrays disponibles dependerán de las fuentes que especifiques en la solicitud. De forma predeterminada, se devolverá el array web.

id
string

El ID de la tarea de búsqueda

success
boolean
warning
string | null

Mensaje de advertencia si ocurre algún problema