> 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/proxies/residential-proxies.md).

# Residential Proxies

Saiba tudo sobre os Residential Proxies da Oxylabs, exemplos de código, parâmetros de segmentação por localização e recursos de troubleshooting.

Oxylabs [**Residential Proxies**](https://oxylabs.io/products/residential-proxy-pool) use endereços IP reais fornecidos por Provedores de Serviços de Internet (ISPs) vinculados a dispositivos físicos em todo o mundo. Esses proxies rotacionam automaticamente a cada solicitação e oferecem suporte a segmentação refinada por país, cidade, estado, CEP, ASN e sessão.

{% hint style="info" %}
**Conectando via IPs em whitelist?** Se preferir autenticar via whitelist de IP em vez de `nome de usuário`/`senha` credenciais, siga nosso [guia de whitelist de IP e autenticação por subdomínio](https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/whitelisting-ips.md).&#x20;
{% endhint %}

## Consulta básica

{% hint style="info" %}
Nossos Residential Proxies oferecem suporte a `HTTP`, `HTTPS`, `HTTP/3 (MASQUE)`, e `SOCKS5` protocolos. Você pode saber mais sobre como usá-los [**aqui**](https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/protocols.md).
{% endhint %}

Fazer uma solicitação básica requer apenas informar suas credenciais de usuário do proxy (`nome de usuário` e `senha`) ao nó de entrada de backconnect (`pr.oxylabs.io:7777`). Cada solicitação é roteada automaticamente por um endereço IP aleatório.

{% tabs %}
{% tab title="cURL" %}

```shell
curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ip.oxylabs.io/location
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php
$username = 'USERNAME';
$password = 'PASSWORD';
$proxy = 'pr.oxylabs.io:7777';
$query = curl_init('https://ip.oxylabs.io/location');
curl_setopt($query, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($query, CURLOPT_PROXY, "http://$proxy");
curl_setopt($query, CURLOPT_PROXYUSERPWD, "customer-$username:$password");
$output = curl_exec($query);
curl_close($query);
if ($output)
    echo $output;
?>
```

{% endtab %}

{% tab title="Python" %}

```python
import urllib.request

username = 'USERNAME'
password = 'PASSWORD'
entry = f'http://customer-{username}:{password}@pr.oxylabs.io:7777'

query = urllib.request.ProxyHandler({
    'http': entry,
    'https': entry,
})
execute = urllib.request.build_opener(query)
print(execute.open('https://ip.oxylabs.io/location').read())
```

{% endtab %}

{% tab title="Java" %}

```java
package example;

import org.apache.http.HttpHost;
import org.apache.http.client.fluent.*;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpHost entry = new HttpHost("pr.oxylabs.io", 7777);
        String query = Executor.newInstance()
            .auth(entry, "customer-USERNAME", "PASS")
            .execute(Request.Get("http://ip.oxylabs.io/location").viaProxy(entry))
            .returnContent().asString();
        System.out.println(query);
    }
}
```

{% endtab %}

{% tab title="C#" %}

```csharp
using System;
using System.Net;

class Example
{
    static void Main()
    {
        var client = new WebClient();
        client.Proxy = new WebProxy("pr.oxylabs.io:7777");
        client.Proxy.Credentials = new NetworkCredential("customer-USERNAME", "PASSWORD");
        Console.WriteLine(client.DownloadString("https://ip.oxylabs.io/location"));
    }
c
```

{% endtab %}

{% tab title="Ruby" %}

```ruby
require 'uri'
require 'net/http'

uri = URI.parse('https://ip.oxylabs.io/location')
proxy = Net::HTTP::Proxy('pr.oxylabs.io', 7777, 'customer-USERNAME', 'PASSWORD')

req = Net::HTTP::Get.new(uri.path)

result = proxy.start(uri.host,uri.port) do |http|
    http.request(req)
end

puts result.body
```

{% endtab %}
{% endtabs %}

### Exemplo de resposta

Testando sua conexão contra <https://ip.oxylabs.io/location> retorna dados da MaxMind, IP2Location, DB-IP e IPinfo.io. Os parâmetros incluem endereço IP, provedor, país, cidade, CEP, ASN, nome da organização e fuso horário.

```json
{
  "ip": "185.220.101.5",
  "provider": "Comcast Cable",
  "country": "United States",
  "country_code": "US",
  "city": "New York",
  "zip": "10001",
  "asn": 7018,
  "organization": "ATT-INTERNET4",
  "timezone": "America/New_York"
}
```

## Personalizando suas solicitações

Depois que uma conexão básica for verificada, personalize suas solicitações de acordo com suas necessidades específicas:

<table data-header-hidden><thead><tr><th width="216"></th><th></th></tr></thead><tbody><tr><td><a href="https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/location-settings.md"><strong>Localização e segmentação geográfica</strong></a></td><td>Aplique parâmetros de país, cidade, estado, continente, CEP, ASN ou coordenadas.</td></tr><tr><td><a href="https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/session-control.md"><strong>Controle de sessão</strong></a></td><td>Sessões fixas (<code>sessid</code>), durações da sessão (<code>sesstime</code>), vinculação a um único IP (<code>sessid_oneip</code>), e faixas de porta fixas.</td></tr><tr><td><a href="https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/protocols.md"><strong>Protocolos e portas</strong></a></td><td>Configurar <code>HTTP</code>, <code>HTTPS</code>, <code>HTTP/3</code>, e <code>SOCKS5</code> conexões.</td></tr><tr><td><a href="https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/advanced-filters.md"><strong>Filtros avançados</strong></a></td><td>Direcione sistemas operacionais específicos (<code>platform</code>) ou versões do protocolo IP.</td></tr><tr><td><a href="https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/whitelisting-ips.md"><strong>Whitelist de IP</strong></a></td><td>Conecte-se sem senhas usando autenticação baseada em IP.</td></tr></tbody></table>

### Parâmetros de consulta

Um único proxy backconnect (`pr.oxylabs.io:7777)` permite personalizar seu proxy por meio de parâmetros adicionais no nome de usuário (geolocalização, sessões fixas etc.). Aqui está um exemplo de credenciais com detalhamento:

<figure><img src="https://1795063165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-d3f1a59d25a42e887f472219825623641de0ef3b%2FCode%20explained%20for%20Resi%20documentation%20(upd%202025-06).png?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="124">Parâmetro</th><th width="114">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td><code>customer</code></td><td>Obrigatório</td><td>Prefixo da string de nome de usuário (por exemplo, <code>customer-USERNAME</code>).</td></tr><tr><td><code>cc</code></td><td>Localização</td><td>Código de país ISO 3166-1 de 2 letras, sem distinção entre maiúsculas e minúsculas (por exemplo, <code>cc-DE</code>, <code>cc-US</code>).</td></tr><tr><td><code>city</code></td><td>Localização</td><td>Nome da cidade em inglês; requer <code>cc</code> (por exemplo, <code>cc-US-city-los_angeles</code>).</td></tr><tr><td><code>st</code></td><td>Localização</td><td>Nome do estado dos EUA com <code>us_</code> prefixo (por exemplo, <code>st-us_california</code>).</td></tr><tr><td><code>cn</code></td><td>Localização</td><td>código de continente de 2 letras (por exemplo, <code>cn-EU</code>, <code>cn-AS</code>).</td></tr><tr><td><code>código postal</code></td><td>Localização</td><td>CEP de 5 dígitos dos EUA; requer <code>cc-US</code> (por exemplo, <code>postalcode-90210</code>).</td></tr><tr><td><code>ASN</code></td><td>Localização</td><td>Número do Sistema Autônomo (por exemplo, <code>ASN-21928</code>).</td></tr><tr><td><code>geohash</code></td><td>Localização</td><td>Direcione células da grade Geohash de nível 1–4 (por exemplo, <code>geohash-u09</code> para Paris).</td></tr><tr><td><code>sessid</code></td><td>Sessão</td><td>String aleatória para manter o IP entre as solicitações (padrão de 10 min).</td></tr><tr><td><code>sesstime</code></td><td>Sessão</td><td>Estenda a duração da sessão em minutos até 1440 min (por exemplo, <code>sesstime-30</code>).</td></tr><tr><td><code>sessid_oneip</code></td><td>Sessão</td><td>Vincula a sessão estritamente a um único nó de saída; falha com 502 em caso de queda.</td></tr><tr><td><code>platform</code></td><td>Filtrar</td><td>Fingerprint de SO alvo (<code>windows</code>, <code>macos</code>, <code>linux</code>, <code>android</code>, <code>ios</code>).</td></tr><tr><td><code>ipversion</code></td><td>Filtrar</td><td>Restringir o pool de proxies a <code>ipversion-4</code> or <code>ipversion-6</code>.</td></tr></tbody></table>

### Formatos comuns de string de proxy

Dependendo do seu fluxo de trabalho, software de terceiros ou scripts personalizados, as credenciais do proxy podem ser formatadas de várias maneiras:

<table><thead><tr><th width="359">Formato</th><th>Caso de uso</th></tr></thead><tbody><tr><td>HOST:PORT:USER:PASS<br>(<code>pr.oxylabs.io:7777:customer-john:pass123</code>)</td><td>Formato de gateway de entrada backconnect usado em ferramentas padrão de automação.</td></tr><tr><td>USER:PASS@HOST:PORT<br>(<code>customer-john:pass123@pr.oxylabs.io:7777</code>)</td><td>Formato URI padrão usado por cURL, Python <code>requests</code>, Node.js <code>axios</code>, etc.</td></tr><tr><td>IP:PORT:USER:PASS<br>(<code>185.220.101.5:8000:john:pass123</code>)</td><td>Formato de IP direto comumente usado em ferramentas de automação de bots e scrapers de desktop.</td></tr><tr><td>USER:PASS:IP:PORT<br>(<code>john:pass123:185.220.101.5:8000</code>)</td><td>Formato de string invertida usado por ferramentas legadas que exigem análise personalizada.</td></tr><tr><td>IP:PORT<br>(<code>185.220.101.5:8000</code>)</td><td>Formato com IP em whitelist (sem nome de usuário/senha necessário).</td></tr></tbody></table>

## Painel e gerenciamento de conta

* Acesse seu [Painel da Oxylabs](https://dashboard.oxylabs.io/en) para ver o uso de tráfego em tempo real, estatísticas de solicitações e gerenciar subusuários.
* Use o [Gerador de Endpoint](https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/endpoint-generator.md) automatizado para gerar e exportar listas personalizadas de proxies em cURL, Python, PHP, Node.js, GO, Java ou detalhes personalizados para integrações.
* Gerencie subusuários e acompanhe o uso de forma programática via [Public API](https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/public-api.md).

## Precisa de assistência técnica?

&#x20;Entre em contato com seu Gerente de Conta ou com nossa equipe de suporte 24/7 usando uma das opções abaixo:

* **Chat ao vivo.** Acesse o chat ao vivo pelo seu painel ou no [**site da Oxylabs**](https://oxylabs.io/) para perguntas rápidas ou relatos de bugs.
* **E-mail**. Você pode entrar em contato conosco por [**support@oxylabs.io**](mailto:support@oxylabs.io). Recomendamos este método para perguntas ou sugestões menos urgentes.


---

# 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/proxies/residential-proxies.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.
