> 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/web-scraper-api/alvos/llms-e-ia.md).

# LLMs e IA

Encontre guias de scraping da Oxylabs Web Scraper API para os LLMs e plataformas de IA mais populares.

Os scrapers LLM da Oxylabs permitem que você envie prompts para as principais plataformas de IA e receba respostas estruturadas e analisadas. Alvos compatíveis:

* [**ChatGPT**](/products/pt-br/web-scraper-api/alvos/llms-e-ia/chatgpt.md) – origem: `chatgpt`
* [**Gemini**](/products/pt-br/web-scraper-api/alvos/llms-e-ia/gemini.md)– origem: `gemini`
* [**Perplexity**](/products/pt-br/web-scraper-api/alvos/llms-e-ia/perplexity.md) – origem: `perplexity`

{% hint style="success" %}
Todos os scrapers dedicados de LLM & IA oferecem suporte a **instruções personalizadas do navegador**. [**Saiba mais**](/products/pt-br/web-scraper-api/features/js-rendering-and-browser-control.md#browser-instructions)**.**
{% endhint %}

### Método de integração

As fontes de LLM & IA usam o [**Push-Pull**](/products/pt-br/web-scraper-api/integration-methods/push-pull.md) método de integração. Em vez de manter a conexão aberta até a resposta ficar pronta, você envia uma tarefa e coleta o resultado quando ela termina:

1. **Envie a tarefa:** envie seu prompt para o endpoint Push-Pull. Você recebe um ID da tarefa imediatamente, não o resultado.
2. **Aguarde a conclusão:** ou deixe que a gente o notifique com `callback_url` (recomendado), ou [verifique o status da tarefa](/products/pt-br/web-scraper-api/integration-methods/push-pull.md#check-job-status) você mesmo.
3. **Recupere o resultado:** quando o status for `concluído`, recupere a resposta analisada.

{% hint style="info" %}
**Realtime e Proxy Endpoint não estão disponíveis** para `chatgpt`, `gemini`, e `perplexity` fontes. Esses alvos levam mais tempo para concluir do que uma conexão síncrona permite, então Push-Pull é o único método suportado.
{% endhint %}

## Exemplo de requisição

Todos os alvos de LLM usam, em sua maioria, os mesmos parâmetros de solicitação; a principal diferença é o comprimento máximo do prompt.

Envie o payload para o endpoint Push-Pull - consulte as páginas individuais de cada alvo para ver exemplos completos de código.

```json
{
  "source": "chatgpt",
  "prompt": "best supplements for better sleep",
  "parse": true,
  "geo_location": "United States",
  "callback_url": "https://your-server.com/oxylabs-callback"
}
```

<table><thead><tr><th width="195.5">Parâmetro</th><th width="452.5">Descrição</th><th width="117">Tipo</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong><code>source</code></strong></mark></td><td>O alvo de LLM a ser extraído. Valores permitidos: <code>chatgpt</code>, <code>perplexity</code>, <code>gemini</code>.</td><td>cadeia de caracteres</td></tr><tr><td><mark style="background-color:green;"><strong><code>prompt</code></strong></mark></td><td>Consulta ou prompt a ser enviado. Comprimento máximo: 4.000 caracteres para <code>chatgpt</code>; 8.000 caracteres para <code>perplexity</code> e <code>gemini</code>.</td><td>cadeia de caracteres</td></tr><tr><td><code>callback_url</code></td><td><strong>Recomendado.</strong> URL onde entregamos uma notificação assim que a tarefa for concluída, para que você não precise verificar o status sozinho. <a href="/products/pt-br/web-scraper-api/integration-methods/push-pull.md"><strong>Mais informações</strong></a>.</td><td>cadeia de caracteres</td></tr><tr><td><code>parse</code></td><td>Defina como <code>true</code> para receber uma resposta JSON estruturada.</td><td>booleano</td></tr><tr><td><code>geo_location</code></td><td>Localização geográfica de origem da solicitação (por exemplo, <code>"United States"</code>).</td><td>cadeia de caracteres</td></tr><tr><td><code>browser_instructions</code></td><td>Execute instruções personalizadas opcionais do navegador ao renderizar JavaScript. <a href="/products/pt-br/web-scraper-api/features/js-rendering-and-browser-control.md#browser-instructions"><strong>Mais informações</strong></a>.</td><td>vetor</td></tr></tbody></table>

\- parâmetro obrigatório

{% hint style="success" %}
**Observação:** A renderização de JavaScript está ativada por padrão para todos os alvos de LLM. Não inclua `render` no payload da sua solicitação.
{% endhint %}

## Resposta

Todos os alvos de LLM retornam a mesma estrutura de dados de nível superior (consulte as páginas individuais de cada alvo para a referência completa dos campos de resposta).

### Envio da tarefa

O envio retorna os detalhes da tarefa, incluindo o ID que você usará para coletar o resultado. Ele **não** contém os dados extraídos.

<table><thead><tr><th width="196">Campo</th><th width="452">Descrição</th><th width="114">Tipo</th></tr></thead><tbody><tr><td><code>id</code></td><td>Identificador exclusivo da tarefa de scraping. Use-o para recuperar o resultado.</td><td>cadeia de caracteres</td></tr><tr><td><code>status</code></td><td>Status atual da tarefa: <code>pendente</code> enquanto ela é executada, <code>concluído</code> quando o resultado estiver pronto, <code>com falha</code> se ela falhar (recupere o resultado somente quando o status for <code>concluído</code>).</td><td>cadeia de caracteres</td></tr><tr><td><code>source</code></td><td>Submetido <code>source</code> valor.</td><td>cadeia de caracteres</td></tr><tr><td><code>parse</code></td><td>Submetido <code>parse</code> valor.</td><td>booleano</td></tr><tr><td><code>prompt</code></td><td>Prompt original na solicitação.</td><td>cadeia de caracteres</td></tr><tr><td><code>geo_location</code></td><td>Localização geográfica usada na solicitação. Verifique a disponibilidade do LLM antes de escolher uma <code>geo_location</code>.</td><td>cadeia de caracteres</td></tr><tr><td><code>created_at</code></td><td>Carimbo de data e hora de criação da tarefa (UTC, <code>YYYY-MM-DD HH:MM:SS</code>).</td><td>cadeia de caracteres</td></tr><tr><td><code>updated_at</code></td><td>Carimbo de data e hora da atualização da tarefa.</td><td>cadeia de caracteres</td></tr></tbody></table>

{% hint style="warning" %}
**Verifique a disponibilidade do LLM antes de escolher uma `geo_location`**

Cada serviço de IA está disponível apenas em determinados países, e só podemos extraí-lo dos países onde o próprio serviço está disponível. Por exemplo, o Gemini não está disponível na China continental, então uma solicitação ao Gemini com `"geo_location": "China"` não pode ser bem-sucedida.

Antes de enviar solicitações, verifique a lista oficial de países compatíveis do provedor:

* **ChatGPT** – [Países compatíveis com o ChatGPT](https://help.openai.com/en/articles/7947663-chatgpt-supported-countries)
* **Gemini** – [Onde você pode usar o app web do Gemini](https://support.google.com/gemini/answer/13575153)
* **Perplexity** – nenhuma lista oficial é publicada.
  {% endhint %}

### Recuperando resultados

Quando o status da tarefa for `concluído`, recupere o resultado usando o `job.id` que você recebeu. O conteúdo analisado específico de cada alvo está em `results[].content` (consulte as páginas individuais de cada alvo para a referência completa dos campos).

<table><thead><tr><th width="196">Campo</th><th width="452">Descrição</th><th width="114">Tipo</th></tr></thead><tbody><tr><td><code>results[].job_id</code></td><td>ID da tarefa associado ao resultado.</td><td>cadeia de caracteres</td></tr><tr><td><code>results[].status_code</code></td><td>Código de status HTTP da coleta da página.</td><td>inteiro</td></tr><tr><td><code>results[].url</code></td><td>Página do alvo de LLM.</td><td>cadeia de caracteres</td></tr><tr><td><code>results[].content</code></td><td>Dados de resposta do LLM. Os campos variam conforme o alvo.</td><td>objeto</td></tr></tbody></table>

### Dados de resposta por alvo

A tabela abaixo mostra quais campos de dados estão disponíveis para cada alvo de LLM.

|                                                                                 | [**ChatGPT**](/products/pt-br/web-scraper-api/alvos/llms-e-ia/chatgpt.md) | [**Gemini**](/products/pt-br/web-scraper-api/alvos/llms-e-ia/gemini.md) | [**Perplexity**](/products/pt-br/web-scraper-api/alvos/llms-e-ia/perplexity.md) |
| ------------------------------------------------------------------------------- | :-----------------------------------------------------------------------: | :---------------------------------------------------------------------: | :-----------------------------------------------------------------------------: |
| Entrada do prompt                                                               |                                     ✓                                     |                                    ✓                                    |                                        ✓                                        |
| Saída analisada (JSON)                                                          |                                     ✓                                     |                                    ✓                                    |                                        ✓                                        |
| Resposta em texto simples                                                       |                                     ✓                                     |                                    ✓                                    |                                        –                                        |
| Saída em Markdown                                                               |                                     ✓                                     |                                    ✓                                    |                                        ✓                                        |
| Árvore JSON em Markdown                                                         |                                     ✓                                     |                                    –                                    |                                        ✓                                        |
| <mark style="background-color:yellow;">Pesquisa / consultas relacionadas</mark> |                                     –                                     |                                    –                                    |                                        ✓                                        |
| <mark style="background-color:yellow;">Citações / fontes</mark>                 |                                     ✓                                     |                                    ✓                                    |                                        ✓                                        |
| <mark style="background-color:yellow;">Resultados de compras</mark>             |                                     ✓                                     |                                    –                                    |                                        –                                        |
| <mark style="background-color:yellow;">Anúncios</mark>                          |                                     ✓                                     |                                    –                                    |                                        –                                        |
| Geolocalização                                                                  |                                     ✓                                     |                                    ✓                                    |                                        ✓                                        |
| Modelo de LLM usado                                                             |                                     –                                     |                                    ✓                                    |                                        ✓                                        |

&#x20;    – condicional, retornado somente quando o conteúdo está na resposta do LLM.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/products/pt-br/web-scraper-api/alvos/llms-e-ia.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.