/search y Firecrawl devuelve títulos, descripciones y URLs. Agrega scrapeOptions para recuperar también el markdown completo de la página, HTML, links o capturas de pantalla de cada resultado.
Los resultados de búsqueda incluyen highlights relevantes para la consulta de forma predeterminada. Establece highlights en false cuando quieras en su lugar la descripción simple o el fragmento de cada sitio web.
Para ver la lista completa de parámetros, consulta la referencia de la API del endpoint Search.
Pruébalo en el Playground
Prueba buscar en el playground interactivo; no necesitas escribir código.
Buscar con Firecrawl
punto de conexión /search
Instalación
Uso básico
Respuesta
JSON
Si usas los SDKs: los resultados de búsqueda se agrupan por tipo de fuente, no en un array genérico
.data. Accede a los resultados web con result.web, a las noticias con result.news y a las imágenes con result.images.Python
JavaScript
Tipos de resultados de búsqueda
sources:
web: resultados web estándar (predeterminado)news: resultados enfocados en noticiasimages: resultados de búsqueda de imágenes
sources: ["web", "news"]). Cuando lo haces, el parámetro limit se aplica por tipo de fuente; así, limit: 5 con sources: ["web", "news"] devuelve hasta 5 resultados web y hasta 5 resultados de noticias (10 en total). Si necesitas parámetros diferentes por fuente (por ejemplo, valores limit distintos o diferentes scrapeOptions), haz llamadas separadas en su lugar.
Categorías de búsqueda
Filtra los resultados de búsqueda por categorías específicas mediante el parámetrocategories:
research: restringe la búsqueda web a sitios web académicos y de investigación (arxiv.org, nature.com, pubmed.ncbi.nlm.nih.gov y similares). A partir del 2026-11-16 pasará a buscar en el Research Index y a devolver registros de artículos; consulta la advertencia más abajopdf: busca PDFdeveloper: busca en el Developer Index: issues, pull requests fusionados y READMEs de repositorios de código públicos, junto con sitios de documentación seleccionados
Búsqueda por categoría de investigación
Restringe la búsqueda web a sitios web académicos y de investigación. Devuelve páginas web alojadas en esos dominios —páginas de inicio, páginas de resúmenes y páginas de editoriales— con los fragmentos habituales:cURL
cURL
Búsqueda por categoría para desarrolladores
Busca en el Developer Index fuentes primarias para responder a una pregunta de programación:cURL
web estándar, cada uno con category: "developer"; la categoría developer no se puede combinar con otras categorías. Para obtener resultados ordenados con los pasajes coincidentes y usar los filtros de repositorio y fuente de documentación, utiliza el endpoint de búsqueda para desarrolladores.
Búsqueda de categorías mixtas
Combina varias categorías en una sola búsqueda:cURL
Filtros de dominio
includeDomains para restringir los resultados de búsqueda a dominios específicos, o excludeDomains para excluir dominios específicos de la búsqueda. Estos campos añaden internamente los operadores site: y -site: a la consulta, así que pasa únicamente los dominios, sin protocolo ni ruta.
includeDomains y excludeDomains son mutuamente excluyentes. Usa uno u otro en una misma solicitud.Dominios incluidos
cURL
Excluir dominios
cURL
Formato de respuesta de categorías
Cada resultado de búsqueda incluye un campocategory que indica su fuente:
cURL
cURL
Búsqueda de imágenes en HD con filtro de tamaño
cURL
cURL
imagesize:1920x1080- Full HD (1080p)imagesize:2560x1440- QHD (1440p)imagesize:3840x2160- 4K UHDlarger:1920x1080- HD o superiorlarger:2560x1440- QHD o superior
Búsqueda con extracción de contenido
scrapeOptions.
Respuesta con contenido rastreado
Buscar y luego hacer scraping (patrón de dos pasos)
Opciones de búsqueda avanzadas
Personalización de la ubicación
Búsqueda por tiempo
Usa el parámetrotbs para filtrar resultados por periodo. Ten en cuenta que tbs solo se aplica a resultados de web — no filtra resultados de news ni de images. Si necesitas noticias filtradas por tiempo, considera usar web como origen con el operador site: para restringir la búsqueda a dominios de noticias específicos.
tbs:
qdr:h- Última horaqdr:d- Últimas 24 horasqdr:w- Última semanaqdr:m- Último mesqdr:y- Último añosbd:1- Ordenar por fecha (las más recientes primero)
sbd:1 con filtros de tiempo para obtener resultados ordenados por fecha dentro de un rango temporal. Por ejemplo, sbd:1,qdr:w devuelve resultados de la última semana ordenados de más recientes a más antiguos, y sbd:1,cdr:1,cd_min:12/1/2024,cd_max:12/31/2024 devuelve resultados de diciembre de 2024 ordenados por fecha.
Tiempo de espera personalizado
Configura un tiempo de espera personalizado para las operaciones de búsqueda:Búsqueda segura
Establecesafe en true para filtrar contenido explícito de los resultados de búsqueda (SafeSearch). Si se omite, los resultados se devuelven sin filtrar, igual que antes.
cURL
Retención de datos cero (ZDR)
/search mediante el parámetro enterprise. La búsqueda con ZDR está disponible en los planes Enterprise — visita firecrawl.dev/enterprise para comenzar.
Esto es distinto de la opción de scrape
zeroDataRetention, que controla la ZDR para las operaciones de scraping. Consulta Scrape ZDR para obtener más información. El parámetro enterprise solo se aplica a la parte de búsqueda de la solicitud.ZDR de extremo a extremo
- Costo: 10 créditos por 10 resultados
- Parámetro:
enterprise: ["zdr"]
cURL
ZDR anonimizado
- Costo: 2 créditos por 10 resultados
- Parámetro:
enterprise: ["anon"]
cURL
Combinar búsqueda ZDR con Scrape ZDR
Si estás usando search con scraping de contenido (scrapeOptions), el parámetro enterprise aplica automáticamente ZDR a cualquier scraping resultante. La siguiente solicitud de ejemplo aplica ZDR tanto a la parte de búsqueda como a la de scraping del proceso:
cURL
Implicaciones de costos
El costo de una búsqueda es de 2 créditos por cada 10 resultados, redondeado hacia arriba (1–10 resultados = 2 créditos, 11–20 = 4 créditos, y así sucesivamente). Si las opciones de scraping están habilitadas, se aplican los costos estándar de scraping a cada resultado de búsqueda:- Basic scrape: 1 crédito por página web
- PDF parsing: 1 crédito por página de PDF
- JSON mode: 4 créditos adicionales por página web
- Establece
parsers: []si no se requiere el análisis de PDF - Limita la cantidad de resultados de búsqueda con el parámetro
limit
Opciones avanzadas de scraping
¿Eres un agente de IA que necesita una API key de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para ver las instrucciones de incorporación automatizada.
Rendimiento medido
Evaluadores independientes han comparado Firecrawl búsqueda con otras APIs de búsqueda. Las cifras siguientes se toman directamente de los resultados publicados por cada evaluador en la fecha indicada.Se trata de mediciones de terceros, cada una con su propio harness, conjunto de tareas y metodología: no son directamente comparables entre sí ni con los benchmarks propios de Firecrawl. La estimación puntual la sitúa en el puesto 2 de 8; las pruebas de bootstrap emparejado no hallaron diferencias estadísticamente significativas frente a Brave, Exa o Parallel búsqueda Pro. Las páginas de benchmarks propios de Firecrawl, incluida la evaluación de código abierto del Developer Index, están en firecrawl.dev/benchmarks.
Comentarios sobre la búsqueda
Cuando un resultado de búsqueda es útil o le falta contenido importante, envía tus comentarios conPOST /v2/search/{jobId}/feedback. El primer envío de comentarios para un trabajo de búsqueda puede reembolsar 1 crédito, según los límites del equipo, y ayuda a mejorar la calidad de búsqueda de Firecrawl. Consulta Comentarios sobre la búsqueda.
