> 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/integration-methods.md).

# Métodos de integração

Explore os três métodos de integração da Oxylabs Web Scraper API (Realtime, Push-Pull, Proxy Endpoint) e aprenda como eles diferem em envio de tarefas, formato e fluxo de trabalho.

Web Scraper API oferece suporte a **três métodos de integração,** cada um com seus benefícios exclusivos:

* [**Realtime**](/products/pt-br/web-scraper-api/integration-methods/realtime.md). Este método é síncrono. Isso significa que, ao enviar sua solicitação de envio da tarefa, **você precisará manter a conexão aberta** até concluirmos com sucesso sua tarefa ou retornarmos um erro. Este método de integração é ideal para extração de dados em Realtime quando você precisa de uma resposta imediata. Você pode enviar payloads JSON com parâmetros de scraping e parsing, enquanto a API lida automaticamente com o gerenciamento de proxies, retentativas e gerenciamento de tráfego de bots.
* [**Push-Pull**](/products/pt-br/web-scraper-api/integration-methods/push-pull.md) **(suporta consultas em lote)**. Este método de integração é **assíncrono**. Isso significa que, ao enviar sua tarefa, retornaremos rapidamente um JSON com as informações da sua tarefa, incluindo as URLs para baixar o resultado/verificar o status da tarefa. Assim que terminarmos de processar sua tarefa, enviaremos `POST` uma notificação de conclusão da tarefa para o seu servidor, momento em que você pode prosseguir e baixar os resultados. Este método de integração também permite enviar os resultados diretamente para seu AWS S3, Google Cloud ou qualquer armazenamento compatível com S3.

{% hint style="success" %}
Push-Pull é nosso método de integração recomendado para lidar de forma confiável com grandes volumes de dados.
{% endhint %}

* [**Proxy Endpoint**](/products/pt-br/web-scraper-api/integration-methods/proxy-endpoint.md). Este método também é síncrono (como Realtime), mas, em vez de usar nosso serviço por meio de uma interface RESTful, você **pode usar nosso endpoint como um proxy**. Use Proxy Endpoint se você já usou proxies antes e só quer obter o conteúdo web disponível conosco.

{% hint style="info" %}
O tempo de vida (**TTL**) para todas as conexões da API é definido como **150 segundos**. É importante observar que, em casos raros, as conexões podem expirar antes de receber uma resposta. Fatores como carga do sistema ou envios de tarefas extremamente complexos podem contribuir para timeouts.
{% endhint %}


---

# 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/web-scraper-api/integration-methods.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.
