Nota: Ya está disponible una versión v2 de esta API con funciones y rendimiento mejorados.El punto de conexión /search combina la búsqueda web (SERP) con las capacidades de scraping de Firecrawl para devolver el contenido completo de la página para cualquier consulta. Incluye
scrapeOptions
con formats: ["markdown"]
para obtener el contenido completo en Markdown de cada resultado de búsqueda; de lo contrario, de forma predeterminada recibirás los resultados del SERP (url, title, description).
Operadores de consulta compatibles
Operador | Funcionalidad | Ejemplos |
---|---|---|
"" | Hace una coincidencia exacta de una cadena de texto | "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 |
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 |
Parámetro de ubicación
location
para obtener resultados de búsqueda con orientación geográfica. Formato: "string"
. Ejemplos: "Germany"
, "San Francisco,California,United States"
.
Consulta la lista completa de ubicaciones admitidas para ver todos los países e idiomas disponibles.
Búsqueda por tiempo
tbs
para filtrar los resultados por periodos de tiempo, incluidos los rangos de fechas personalizados. Consulta la documentación de la función de búsqueda para ver ejemplos detallados y los formatos compatibles.Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
The search query
Maximum number of results to return
Required range:
1 <= x <= 100
Time-based search parameter. Supports predefined time ranges (qdr:h
, qdr:d
, qdr:w
, qdr:m
, qdr:y
) and custom date ranges (cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY
)
Location parameter for search results
Timeout in milliseconds
Excludes URLs from the search results that are invalid for other Firecrawl endpoints. This helps reduce errors if you are piping data from search into other Firecrawl API endpoints.
Options for scraping search results