/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
Buscar con Firecrawl
punto de conexión /search
Instalación
Para optar a la recompensa, completa una entrevista sustanciosa (casos de uso concretos y bien planteados, etc.) con nuestro Asistente de comentarios de Firecrawl. Solo lleva unos minutos, puedes detenerla en cualquier momento y es apta tanto para personas como para agentes (¡solo pega el enlace en tu entorno de agentes!). Resulta especialmente útil si buscas o haces scraping en sitios gubernamentales, judiciales, regulatorios o de registros públicos y conoces sus particularidades de primera mano.
Iniciar la entrevistaIncluye tu correo electrónico para poder optar a la recompensa. La calidad de las entrevistas se revisa al final de cada semana.
Uso básico
Respuesta
.data. Accede a los resultados web con result.web, a las noticias con result.news y a las imágenes con result.images.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
categories:
github: Busca en repositorios, código, issues y documentación de GitHubresearch: Busca en sitios académicos y de investigación (arXiv, Nature, IEEE, PubMed, etc.)pdf: Busca archivos PDFdeveloper: Busca en el Índice de desarrolladores — issues, pull requests fusionadas y archivos README de repositorios de código públicos, junto con sitios de documentación seleccionados
Búsqueda de categorías en GitHub
Búsqueda por categoría de investigación
Búsqueda por categoría para desarrolladores
developer, junto a web, cada uno con category: "developer". 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
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
Excluir dominios
Formato de respuesta de categorías
category que indica su fuente:
Búsqueda de imágenes en HD con filtro de tamaño
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
tbs 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
Búsqueda segura
safe 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.
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.
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"]
ZDR anonimizado
- Costo: 2 créditos por 10 resultados
- Parámetro:
enterprise: ["anon"]
Combinar Search ZDR con Scrape ZDR
scrapeOptions), el parámetro enterprise cubre la parte de búsqueda, mientras que zeroDataRetention en scrapeOptions cubre la parte de scraping. Para obtener ZDR completo en ambos, configura ambos:
Implicaciones de costos
- Basic scrape: 1 crédito por página web
- PDF parsing: 1 crédito por página de PDF
- Enhanced proxy mode: 4 créditos adicionales por página web
- JSON mode: 4 créditos adicionales por página web
- Establece
parsers: []si no se requiere el análisis de PDF - Usa
proxy: "basic"en lugar de"enhanced"cuando sea posible, o configúralo en"auto" - 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.
Comentarios sobre la búsqueda
POST /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.
