> 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/documentation/pt-br/comecar/quick-start-web-unblocker.md).

# Início rápido: Web Unblocker

Comece a usar o Web Unblocker da Oxylabs em apenas alguns minutos com um guia simples, passo a passo.

{% hint style="success" %}
Já está familiarizado com o básico? Confira [Documentação do Web Unblocker](/products/pt-br/web-unblocker.md).
{% endhint %}

Oxylabs [Web Unblocker](https://oxylabs.io/products/web-unblocker) é uma solução de proxies com tecnologia de IA, projetada para lidar com os sistemas de gerenciamento de tráfego de bots mais sofisticados (por exemplo, Akamai, Cloudflare ou DataDome). Ela gerencia automaticamente a rotação de proxies, a impressão digital do navegador e o tratamento de CAPTCHA, para que você possa se concentrar nos dados.

{% stepper %}
{% step %}

### Configuração e credenciais

1. **Crie uma conta:** Cadastre-se no [Painel da Oxylabs](https://dashboard.oxylabs.io/).
2. **Crie um usuário de API:** Acesse Web Unblocker → Usuários e crie um nome de usuário e uma senha (Essas são credenciais para autorizar o acesso ao Web Unblocker e são separadas do seu login do painel)
   {% endstep %}

{% step %}

### Sua primeira solicitação

Web Unblocker é integrado como um proxy. Use o endpoint `unblock.oxylabs.io:60000` e passe suas instruções por meio de cabeçalhos personalizados.

```bash
curl -k -x unblock.oxylabs.io:60000 -U 'USERNAME:PASSWORD' \
'https://sandbox.oxylabs.io/products' \
-H 'x-oxylabs-geo-location: United States' \
-H 'x-oxylabs-render: html'
```

{% hint style="info" %}
Substitua `USERNAME` e `PASSWORD` pelas credenciais do seu usuário
{% endhint %}
{% endstep %}
{% endstepper %}

### Cabeçalhos essenciais

Ao contrário dos proxies padrão, o Web Unblocker usa cabeçalhos para controlar seus recursos orientados por IA:

| Cabeçalho                 | Valor                              | Descrição                                                                           |
| ------------------------- | ---------------------------------- | ----------------------------------------------------------------------------------- |
| `x-oxylabs-geo-location`  | `Estados Unidos`, `Alemanha`, etc. | Define o nó de saída para um país específico.                                       |
| `x-oxylabs-render`        | `HTML` ou `png`                    | Ativa a renderização de JavaScript ou retorna uma captura de tela.                  |
| `x-oxylabs-session-id`    | `AnyRandomString`                  | Mantém o mesmo IP por várias solicitações (Sessão Persistente).                     |
| `x-oxylabs-force-headers` | `1`                                | Força a ferramenta a enviar seus próprios cabeçalhos personalizados para o destino. |

### Códigos de resposta comuns

| Código | Status                | Descrição                                                          |
| ------ | --------------------- | ------------------------------------------------------------------ |
| `200`  | `OK`                  | Solicitação bem-sucedida. Você recebe o HTML renderizado completo. |
| `401`  | `Não autorizado`      | Credenciais de Usuário de API inválidas ou autenticação ausente.   |
| `429`  | `Muitas solicitações` | Você atingiu o limite de taxa da sua conta.                        |
| `550`  | `Com falha`           | O sistema não conseguiu acessar o site após várias tentativas.     |

Você pode encontrar a [lista completa de códigos de resposta](/products/pt-br/web-unblocker/response-codes.md) na seção do produto Web Unblocker.

### Próximos passos

* **Controle avançado do navegador:** Precisa clicar em botões ou rolar? Confira as [Instruções personalizadas do navegador](/products/pt-br/web-unblocker/custom-browser-instructions.md) na seção Produtos.
* **Segmentação geográfica:** Para dados localizados, veja a [Geo-location](/products/pt-br/web-unblocker/making-requests/geo-location.md) página para direcionar países, cidades ou coordenadas específicas.


---

# 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/documentation/pt-br/comecar/quick-start-web-unblocker.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.
