Saltar al contenido principal
POST
/
search
Buscar y, opcionalmente, hacer scraping de los resultados de búsqueda
curl --request POST \
  --url https://api.firecrawl.dev/v1/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "limit": 5,
  "tbs": "<string>",
  "location": "<string>",
  "timeout": 60000,
  "ignoreInvalidURLs": false,
  "scrapeOptions": {}
}
'
{
  "success": true,
  "data": [
    {
      "title": "<string>",
      "description": "<string>",
      "url": "<string>",
      "markdown": "<string>",
      "html": "<string>",
      "rawHtml": "<string>",
      "links": [
        "<string>"
      ],
      "screenshot": "<string>",
      "metadata": {
        "title": "<string>",
        "description": "<string>",
        "sourceURL": "<string>",
        "statusCode": 123,
        "error": "<string>"
      }
    }
  ],
  "warning": "<string>"
}
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 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 (url, title, description).

Operadores de consulta compatibles

Ofrecemos una variedad de operadores de consulta que te permiten filtrar mejor tus búsquedas.
OperadorFuncionalidadEjemplos
""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íficosite:firecrawl.dev
inurl:Devuelve solo resultados que incluyan una palabra en la URLinurl:firecrawl
allinurl:Devuelve solo resultados que incluyan varias palabras en la URLallinurl:git firecrawl
intitle:Devuelve solo resultados que incluyan una palabra en el título de la páginaintitle:Firecrawl
allintitle:Devuelve solo resultados que incluyan varias palabras en el título de la páginaallintitle:firecrawl playground
related:Devuelve solo resultados relacionados con un dominio específicorelated:firecrawl.dev

Parámetro de ubicación

Usa el parámetro 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. Usa el parámetro 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.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cuerpo

application/json
query
string
requerido

Consulta de búsqueda

limit
integer
predeterminado:5

Número máximo de resultados que se devolverán

Rango requerido: 1 <= x <= 100
tbs
string

Parámetro de búsqueda temporal. Admite intervalos de tiempo predefinidos (qdr:h, qdr:d, qdr:w, qdr:m, qdr:y) y rangos de fechas personalizados (cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY).

location
string

Parámetro de ubicación para los resultados de búsqueda

timeout
integer
predeterminado:60000

Tiempo de espera en milisegundos

ignoreInvalidURLs
boolean
predeterminado:false

Excluye de los resultados de búsqueda las URLs que no son válidas para otros endpoints de Firecrawl. Esto ayuda a reducir errores si canalizas datos de la búsqueda hacia otros endpoints de la API de Firecrawl.

scrapeOptions
object

Opciones para extraer resultados de búsqueda

Respuesta

Respuesta correcta

success
boolean
data
object[]
warning
string | null

Mensaje de advertencia si ocurre algún problema