> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/es/ai-studio/ai-search.md).

# AI-Search

Aprende a buscar en la web con IA. Describe tus necesidades en inglés sencillo y deja que la herramienta gestione la búsqueda por ti.

## Descripción general

La [**AI-Search**](https://aistudio.oxylabs.io/apps/search) app de [**Oxylabs AI Studio**](https://aistudio.oxylabs.io/) es una herramienta de búsqueda web que permite a los desarrolladores recuperar resultados de búsqueda, extraerlos opcionalmente y manejar con facilidad contenido renderizado con JavaScript. Está diseñada para actuar como un agente de búsqueda inteligente que simplifica el proceso de extraer información relevante directamente en tus aplicaciones de Python.

Ya sea que necesites una lista simple de URLs o una extracción profunda de contenido, AI Search elimina la complejidad de crear desde cero rastreadores de búsqueda personalizados.

## Características clave

* **Consulta la web usando inglés sencillo:** Simplemente proporciona tu consulta de búsqueda en lenguaje natural y deja que el agente haga el trabajo pesado.
* **Controla el número de resultados de búsqueda:** Define fácilmente exactamente cuántos resultados deseas recuperar.
* **Raspado opcional de contenido para páginas de resultados:** Raspa y extrae automáticamente fragmentos de contenido directamente de los resultados de búsqueda devueltos.
* **Renderizado en Python para contenido dinámico:** Habilita el renderizado para manejar y extraer sin problemas datos de sitios web con mucho JavaScript.

## Cómo funciona

Para usar el agente de búsqueda, sigue estos sencillos pasos:

1. **Introduce la consulta de búsqueda** que quieres buscar.
2. **Establece el número deseado de resultados** para limitar o ampliar el alcance de tu búsqueda.
3. **Activa o desactiva el raspado de contenido y el renderizado de JS** según si necesitas una extracción profunda de contenido o solo URLs y títulos.

### Instalación

Para comenzar, asegúrate de tener acceso a una clave de API (o [obtén una prueba gratuita](https://aistudio.oxylabs.io/register) con **1.000 créditos**) y `Python 3.10+` instalado. Puedes instalar el `oxylabs-ai-studio` paquete usando pip:

```bash
pip install oxylabs-ai-studio
```

### Ejemplo de código (Python)

El siguiente ejemplo demuestra cómo usar el `AI-Search` agente para escenarios de obtención de datos.

```python
from oxylabs_ai_studio.apps.ai_search import AiSearch

search = AiSearch(api_key="<API_KEY>")

query = "lasagna recipes"
result = search.search(
    query=query,
    limit=5,
    render_javascript=False,
    return_content=True,
)
print(result.data)

# Or for fast search
result = search.instant_search(
    query=query,
    limit=10,
)
print(result.data)
```

Obtén más información sobre AI-Search y el SDK de Python de Oxylabs AI Studio en nuestro [repositorio de PyPI](https://pypi.org/project/oxylabs-ai-studio/). También puedes consultar nuestra [SDK de JavaScript de AI Studio](https://github.com/oxylabs/oxylabs-ai-studio-js) guía para usuarios de JS.

### Parámetros de solicitud

| Parámetro                                               | Descripción                                                   | Valor predeterminado |
| ------------------------------------------------------- | ------------------------------------------------------------- | -------------------- |
| <mark style="background-color:green;">`consulta`</mark> | Qué buscar                                                    | –                    |
| `limit`                                                 | Número máximo de resultados a devolver (Máximo: 50)           | 10                   |
| `render_javascript`                                     | Habilitar renderizado de JavaScript                           | `False`              |
| `return_content`                                        | Si se deben devolver contenidos en Markdown en los resultados | `True`               |
| `geo_location`                                          | Ubicación del proxy en formato ISO2                           | –                    |

– parámetros obligatorios

**Nota:** Cuando `limit <= 10` y `return_content=False`, la búsqueda usa automáticamente el endpoint instantáneo (`/search/instant`) que devuelve resultados inmediatamente sin sondeo, proporcionando tiempos de respuesta más rápidos.

{% hint style="info" %}
**Nota:** Cuando `limit <= 10` y `return_content=False`, la búsqueda usa automáticamente el endpoint instantáneo (`/search/instant`) que devuelve resultados inmediatamente sin sondeo, proporcionando tiempos de respuesta más rápidos.
{% endhint %}

Parámetros compatibles con la búsqueda instantánea:

| Parámetro                                               | Descripción                                                                                                                 | Valor predeterminado |
| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| <mark style="background-color:green;">`consulta`</mark> | Qué buscar                                                                                                                  | –                    |
| `limit`                                                 | El número máximo de resultados de búsqueda a devolver (Máx: `10`)                                                           | `10`                 |
| `geo_location`                                          | El nombre canónico de Google de la ubicación. Ver más [aquí](https://developers.google.com/google-ads/api/data/geotargets). | –                    |

– parámetros obligatorios

### Ejemplo de salida

```python
[
  {
    "url": "https://www.spendwithpennies.com/easy-homemade-lasagna/",
    "title": "Easy Homemade Lasagna Recipe - Spend With Pennies",
    "description": "Rating 5.0 (3,349) · 1 hr 45 min This is the best LASAGNA RECIPE! Pasta, an easy meat sauce, and ricotta cheese are layered and then topped with more cheese before baking.",
    "content": null
  },
  {
    "url": "https://www.simplyrecipes.com/recipes/lasagna/",
    "title": "The Best Homemade Lasagna - Simply Recipes",
    "description": "Rating 4.9 (115) · 1 hr 45 min This classic lasagna recipe is made with an easy meat sauce as the base. Layer the sauce with noodles and cheese, then bake until bubbly!",
    "content": null
  },
  {
    "url": "https://www.seriouseats.com/12-lasagna-recipes-11808722",
    "title": "12 Must-Try Lasagna Recipes Featuring Crispy Edges and Gooey ...",
    "description": "Whether you have a taste for meaty classics like a lasagna alla Bolognese or an indulgent creamy vegetarian spinach lasagna, we've rounded up our favorite ...",
    "content": null
  },
  {
    "url": "https://bakerbynature.com/the-best-homemade-lasagna-recipe/",
    "title": "The Best Easy Homemade Lasagna Recipe - Baker by Nature",
    "description": "Rating 5.0 (71) · 2 hr 45 min Dec 12, 2025 · This is the ONLY lasagna recipe you'll ever need... from perfectly cooked noodles to rich tomato sauce and layers of cheese.",
    "content": null
  },
  {
    "url": "https://www.allrecipes.com/recipe/23600/worlds-best-lasagna/",
    "title": "World's Best Lasagna Recipe (with Video) - Allrecipes",
    "description": "Rating 4.8 (20,950) · 3 hr 15 min Feb 5, 2026 · This lasagna recipe from John Chandler is our most popular recipe! With sausage, ground beef, basil, and 3 types of cheese, it lives up to ...",
    "content": null
  }
]
```

## Casos de uso prácticos

AI-Search se puede aplicar a una amplia variedad de tareas de descubrimiento y recopilación de datos:

1. **Busca las últimas noticias o artículos sobre un tema –** Reúne rápidamente información actualizada, titulares y resúmenes.
2. **Descubre libros, películas o productos –** Recupera listas de elementos que coincidan con criterios o reseñas específicas.
3. **Investiga ofertas de la competencia –** Encuentra y analiza precios, funciones y posicionamiento en el mercado de la competencia.
4. **Agrega novedades del sector desde múltiples sitios –** Compila cambios y tendencias relevantes del sector en un único feed estructurado.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/es/ai-studio/ai-search.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.