> 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 na submissão do job, no formato e no fluxo de trabalho.

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

* [**Push-Pull**](https://developers.oxylabs.io/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 seu job, retornaremos rapidamente um JSON com as informações do seu job, incluindo as URLs para baixar o resultado/verificar o status do job. Assim que terminarmos de processar seu job, nós iremos `POST` enviar uma notificação de conclusão do job para o seu servidor, momento em que você poderá baixar os resultados. Este método de integração também permite enviar 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 com grandes volumes de dados de forma confiável.
{% endhint %}

* [**Realtime**](https://developers.oxylabs.io/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 do job, **você terá que manter a conexão aberta** até concluirmos seu job com sucesso ou retornarmos um erro. Este método de integração é ideal para extração de dados em tempo real 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 proxy, as tentativas e o tráfego de bots.
* [**Proxy Endpoint**](https://developers.oxylabs.io/products/pt-br/web-scraper-api/integration-methods/proxy-endpoint.md). Este método também é síncrono (assim 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ó quiser obter o conteúdo web disponível conosco.

{% hint style="info" %}
O Time-To-Live (**TTL**) para todas as conexões da API está definido em **150 segundos**. É importante observar que, em casos raros, as conexões podem atingir timeout antes de receber uma resposta. Fatores como carga do sistema ou envios de jobs 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 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/integration-methods.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.
