Búsqueda - Firecrawl Docs

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 mediante el parámetro categories:

research: Limita la búsqueda web a sitios web académicos y de investigación (arxiv.org, nature.com, ieee.org, pubmed.ncbi.nlm.nih.gov, biorxiv.org, medrxiv.org y similares). Devuelve resultados de páginas web convencionales con fragmentos, no registros de artículos
pdf: Busca archivos PDF
developer: Busca en el Developer Index: issues, pull requests fusionadas y archivos README de repositorios de código públicos, además de sitios de documentación seleccionados

Note

research es un filtro de sitios web, no el índice de artículos. Limita los resultados web de este endpoint a una lista fija de dominios académicos.

Para buscar literatura científica directamente —resúmenes de artículos de PubMed, bioRxiv, medRxiv y arXiv, además de la lectura de pasajes dentro de artículos y la expansión del grafo de citas—, utiliza el Research Index en GET /search/research/papers.

Ejemplo de uso#

{  "query": "aprendizaje automático",  "categories": ["research", "pdf"],  "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://arxiv.org/abs/2024.12345",        "title": "ML Research Paper",        "description": "Latest advances in machine learning",        "category": "research"      },      {        "url": "https://example.com/ml-survey.pdf",        "title": "ML Survey",        "description": "A survey of machine learning methods",        "category": "pdf"      }    ]  }}

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.