# AI-Search

## Visão geral

A [**AI-Search**](https://aistudio.oxylabs.io/apps/search) app por [**Oxylabs AI Studio**](https://aistudio.oxylabs.io/) é uma ferramenta de busca na web que permite aos desenvolvedores recuperar resultados de pesquisa, opcionalmente fazer scraping deles e lidar com conteúdo renderizado em JavaScript com facilidade. Ela foi criada para atuar como um agente de busca inteligente que simplifica o processo de extrair informações relevantes diretamente para suas aplicações Python.

Se você precisa de uma lista simples de URLs ou de extração profunda de conteúdo, AI Search elimina a complexidade de criar raspadores de busca personalizados do zero.

## Principais recursos

* **Faça consultas na web usando inglês simples:** Basta fornecer sua consulta de pesquisa em linguagem natural e deixar o agente fazer o trabalho pesado.
* **Controle o número de resultados da pesquisa:** Defina facilmente exatamente quantos resultados você quer recuperar.
* **Scraping de conteúdo opcional para páginas de resultados:** Faça scraping e extraia automaticamente trechos de conteúdo diretamente dos resultados de pesquisa retornados.
* **Renderização Python para conteúdo dinâmico:** Ative a renderização para lidar e extrair dados de sites com muito JavaScript de forma fluida.

## Como funciona

Para usar o agente de busca, siga estes passos simples:

1. **Insira a consulta de pesquisa** que você quer procurar.
2. **Defina o número desejado de resultados** para limitar ou ampliar o escopo da sua busca.
3. **Ative ou desative o scraping de conteúdo e a renderização de JS** com base em se você precisa de extração profunda de conteúdo ou apenas URLs e títulos.

### Instalação

Para começar, certifique-se de que você tem acesso a uma chave de API (ou [obtenha um teste gratuito](https://aistudio.oxylabs.io/register) com **1.000 créditos**) e `Python 3.10+` instalado. Você pode instalar o `oxylabs-ai-studio` pacote usando pip:

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

### Exemplo de código (Python)

O exemplo a seguir demonstra como usar o `AI-Seaerch` agente para cenários de recuperação de dados.

```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)
```

Saiba mais sobre AI-Search e o SDK Python do Oxylabs AI Studio em nosso [repositório PyPI](https://pypi.org/project/oxylabs-ai-studio/). Você também pode conferir nosso [SDK JavaScript do AI Studio](https://github.com/oxylabs/oxylabs-ai-studio-js) guia para usuários de JS.

### Parâmetros da Solicitação

| Parâmetro                                            | Descrição                                             | Valor padrão |
| ---------------------------------------------------- | ----------------------------------------------------- | ------------ |
| <mark style="background-color:green;">`query`</mark> | O que pesquisar                                       | –            |
| `limit`                                              | Número máximo de resultados a retornar (Máximo: 50)   | 10           |
| `render_javascript`                                  | Ativar renderização de JavaScript                     | `False`      |
| `return_content`                                     | Se deve retornar conteúdos em Markdown nos resultados | `True`       |
| `geo_location`                                       | Localização do proxy no formato ISO2                  | –            |

&#x20;    – parâmetros obrigatórios

**Observação:** Quando `limit <= 10` e `return_content=False`, a busca usa automaticamente o endpoint instantâneo (`/search/instant`) que retorna os resultados imediatamente sem polling, proporcionando tempos de resposta mais rápidos.

{% hint style="info" %}
**Observação:** Quando `limit <= 10` e `return_content=False`, a busca usa automaticamente o endpoint instantâneo (`/search/instant`) que retorna os resultados imediatamente sem polling, proporcionando tempos de resposta mais rápidos.
{% endhint %}

Parâmetros suportados na busca instantânea:

| Parâmetro                                            | Descrição                                                                                                                   | Valor padrão |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ------------ |
| <mark style="background-color:green;">`query`</mark> | O que pesquisar                                                                                                             | –            |
| `limit`                                              | O número máximo de resultados de pesquisa a retornar (Máx: `10`)                                                            | `10`         |
| `geo_location`                                       | Nome canônico do Google para a localização. Veja mais [aqui](https://developers.google.com/google-ads/api/data/geotargets). | –            |

&#x20;    – parâmetros obrigatórios

### Exemplo de Saída

```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áticos

O AI-Search pode ser aplicado a uma ampla variedade de tarefas de descoberta e coleta de dados:

1. **Pesquise as notícias ou artigos mais recentes sobre um tema –** Reúna rapidamente informações atualizadas, manchetes e resumos.
2. **Descubra livros, filmes ou produtos –** Recupere listas de itens que correspondem a critérios específicos ou avaliações.
3. **Pesquise ofertas competitivas –** Encontre e analise preços, recursos e posicionamento de mercado dos concorrentes.
4. **Agregue atualizações do setor de vários sites –** Compile mudanças e tendências relevantes do setor em um único feed estruturado.


---

# Agent Instructions: 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:

```
GET https://developers.oxylabs.io/products/pt-br/ai-studio/ai-search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.