# Búsqueda

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.

<div id="supported-query-operators">
  ## Operadores de consulta admitidos
</div>

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`

<div id="location-parameter">
  ## Parámetro de ubicación
</div>

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](https://firecrawl.dev/search_locations.json) para ver todos los países e idiomas disponibles.

<div id="country-parameter">
  ## Parámetro country
</div>

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"`.

```json
{
  "query": "restaurantes",
  "country": "DE"
}
```

<div id="categories-parameter">
  ## Parámetro Categories
</div>

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](/es/features/developer): 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](/es/features/research) en [`GET /search/research/papers`](/es/api-reference/endpoint/research-search-papers).
</Note>

<div id="example-usage">
  ### Ejemplo de uso
</div>

```json
{
  "query": "aprendizaje automático",
  "categories": ["research", "pdf"],
  "limit": 10
}
```

<div id="domain-filters">
  ## Filtros de dominio
</div>

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.

<div id="include-domains-example">
  ### Ejemplo de inclusión de dominios
</div>

```json
{
  "query": "web scraping",
  "includeDomains": ["firecrawl.dev", "docs.firecrawl.dev"],
  "limit": 10
}
```

<div id="exclude-domains-example">
  ### Ejemplo de exclusión de dominios
</div>

```json
{
  "query": "web scraping tools",
  "excludeDomains": ["example.com"],
  "limit": 10
}
```

<div id="category-response">
  ### Respuesta de categoría
</div>

Cada resultado incluye un campo `category` que indica su origen:

```json
{
  "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"
      }
    ]
  }
}
```

<div id="time-based-search">
  ## Búsqueda por tiempo
</div>

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](https://docs.firecrawl.dev/features/search#time-based-search) 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](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para obtener instrucciones para la incorporación automatizada.