> 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/pt-br/ai-studio/ai-search.md).

# AI-Search

Saiba como pesquisar na web com IA. Descreva suas necessidades em inglês simples e deixe a ferramenta cuidar da pesquisa para você.

## Visão geral

A URL [**AI-Search**](https://aistudio.oxylabs.io/apps/search) app de [**Oxylabs AI Studio**](https://aistudio.oxylabs.io/) é uma ferramenta de busca na web que permite aos desenvolvedores recuperar resultados de busca, 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.

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

## Principais recursos

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

## Como funciona

Para usar o agente de busca, siga estas etapas simples:

1. **Insira a consulta de busca** que você quer pesquisar.
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 uma avaliação gratuita](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 Oxylabs AI Studio Python SDK em nosso [repositório PyPI](https://pypi.org/project/oxylabs-ai-studio/). Você também pode conferir nosso [SDK JavaScript da 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                  | –            |

– 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 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 resultados imediatamente sem polling, proporcionando tempos de resposta mais rápidos.
{% endhint %}

Parâmetros compatíveis com 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 busca a retornar (Máx.: `10`)                                                          | `10`         |
| `geo_location`                                       | Nome canônico da localização no Google. Veja mais [aqui](https://developers.google.com/google-ads/api/data/geotargets). | –            |

– parâmetros obrigatórios

### Exemplo de saída

```python
[
  {
    "url": "https://www.spendwithpennies.com/easy-homemade-lasagna/",
    "title": "Receita fácil de lasanha caseira - Spend With Pennies",
    "description": "Avaliação 5.0 (3.349) · 1 h 45 min Esta é a MELHOR RECEITA DE LASANHA! Massa, um molho de carne fácil e queijo ricota são colocados em camadas e depois cobertos com mais queijo antes de assar.",
    "content": null
  },
  {
    "url": "https://www.simplyrecipes.com/recipes/lasagna/",
    "title": "A melhor lasanha caseira - Simply Recipes",
    "description": "Avaliação 4.9 (115) · 1 h 45 min Esta receita clássica de lasanha é feita com um molho de carne fácil como base. Monte o molho com massa e queijo e depois asse até borbulhar!",
    "content": null
  },
  {
    "url": "https://www.seriouseats.com/12-lasagna-recipes-11808722",
    "title": "12 receitas de lasanha imperdíveis com bordas crocantes e recheio ...",
    "description": "Se você gosta de clássicos carnudos como uma lasanha à bolonhesa ou de uma indulgente lasanha vegetariana cremosa de espinafre, reunimos nossos favoritos ...",
    "content": null
  },
  {
    "url": "https://bakerbynature.com/the-best-homemade-lasagna-recipe/",
    "title": "A melhor receita fácil de lasanha caseira - Baker by Nature",
    "description": "Avaliação 5.0 (71) · 2 h 45 min 12 de dez. de 2025 · Esta é a ÚNICA receita de lasanha de que você vai precisar... de massa perfeitamente cozida a rico molho de tomate e camadas de queijo.",
    "content": null
  },
  {
    "url": "https://www.allrecipes.com/recipe/23600/worlds-best-lasagna/",
    "title": "A melhor receita de lasanha do mundo (com vídeo) - Allrecipes",
    "description": "Avaliação 4.8 (20.950) · 3 h 15 min 5 de fev. de 2026 · Esta receita de lasanha de John Chandler é a nossa receita mais popular! Com linguiça, carne moída, manjericão e 3 tipos de queijo, ela faz jus ao ...",
    "content": null
  }
]
```

## Casos de uso práticos

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

1. **Pesquisar as últimas notícias ou artigos sobre um tópico –** Reúna rapidamente informações atualizadas, manchetes e resumos.
2. **Descobrir livros, filmes ou produtos –** Recupere listas de itens que correspondam a critérios específicos ou avaliações.
3. **Pesquisar 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 feed único e estruturado.


---

# 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/pt-br/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.