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.

Operador	Funcionalidad	Ejemplos
`""`	Coincidencia exacta de una cadena de texto (no difusa)	`"Firecrawl"`
`-`	Excluye ciertas palabras clave o niega otros operadores	`-bad`, `-site:firecrawl.dev`
`site:`	Devuelve solo resultados de un sitio web específico	`site:firecrawl.dev`
`filetype:`	Devuelve solo resultados con una extensión de archivo específica	`filetype:pdf`, `-filetype:pdf`
`inurl:`	Devuelve solo resultados que incluyan una palabra en la URL	`inurl:firecrawl`
`allinurl:`	Devuelve solo resultados que incluyan varias palabras en la URL	`allinurl:git firecrawl`
`intitle:`	Devuelve solo resultados que incluyan una palabra en el título de la página	`intitle:Firecrawl`
`allintitle:`	Devuelve solo resultados que incluyan varias palabras en el título de la página	`allintitle:firecrawl playground`
`related:`	Devuelve solo resultados relacionados con un dominio específico	`related:firecrawl.dev`
`imagesize:`	Devuelve solo imágenes con dimensiones exactas	`imagesize:1920x1080`
`larger:`	Devuelve solo imágenes más grandes que las dimensiones especificadas	`larger:1920x1080`

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".

{
  "query": "restaurantes",
  "country": "DE"
}

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

{
  "query": "aprendizaje automático",
  "categories": ["github", "investigación"],
  "limit": 10
}

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

{
  "query": "web scraping",
  "includeDomains": ["firecrawl.dev", "docs.firecrawl.dev"],
  "limit": 10
}

Ejemplo de exclusión de dominios

{
  "query": "web scraping tools",
  "excludeDomains": ["example.com"],
  "limit": 10
}

Respuesta de categoría

Cada resultado incluye un campo category que indica su origen:

{
  "success": true,
  "data": {
    "web": [
      {
        "url": "https://github.com/example/ml-project",
        "title": "Machine Learning Project",
        "description": "Implementation of ML algorithms",
        "category": "github"
      },
      {
        "url": "https://arxiv.org/abs/2024.12345",
        "title": "ML Research Paper",
        "description": "Latest advances in machine learning",
        "category": "research"
      }
    ]
  }
}

Búsqueda por tiempo

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.

On this page