Geolocalização e seleção de proxy

Descubra como usar os parâmetros de localização do Oxylabs Agent Browser para acessar dados web de localizações específicas.

Use os parâmetros de geolocalização e roteamento de proxy diretamente na URL de conexão WebSocket para direcionar suas sessões automatizadas do Agent Browser por regiões geográficas específicas e controlar o uso do IP do seu proxy.

Parâmetros de geolocalização

Você pode direcionar locais geográficos específicos por país, estado ou cidade usando três parâmetros de consulta principais.

País

p_cc	Código de país de 2 letras (ex.: US, DE, FR). Se nenhum país for especificado, ele é atribuído automaticamente com base na disponibilidade.

wss://USER:[e-mail]?p_cc=US

Cidade

p_city	Nome da cidade escrito em letras minúsculas (ex.: berlin, los_angeles). Também deve especificar p_cc ou p_state.

wss://USER:[e-mail]?p_cc=US&p_city=new_york

A segmentação no nível da cidade funciona como preferência de melhor esforço. Se o pool de proxies residenciais não tiver um proxy disponível na localização exata solicitada, ele faz fallback automaticamente para o escopo do país.

Estado (somente EUA)

p_state	Nome do estado dos EUA em letras minúsculas (ex.: texas, ohio). Veja a lista completa de estados compatíveis.

wss://USER:[e-mail]?p_state=texas&p_city=houston

Observação: Se p_state e p_cc forem ambos especificados, p_state tem prioridade e p_cc é ignorado.

Seleção de proxy (Proxies persistentes)

Por padrão, o gateway de proxy atribui um IP de saída novo para cada sessão única de conexão do navegador. Como alternativa, você pode fixar um IP de saída residencial específico em tentativas contínuas de conexão do navegador incluindo os proxy_resi_ses_id e proxy_resi_ses_time parâmetros.

Parâmetro	Descrição	Tipo
proxy_resi_ses_id	Nome alfanumérico do rastreador de sessão, de 3 a 36 caracteres.	cadeia de caracteres
proxy_resi_ses_time	Número de minutos para manter o IP de saída do proxy residencial fixado. Mín. – 1 minuto, máx. – 1440 minutos (24 horas).	inteiro

# Example: Pin a US-based IP for a 60 minutes
wss://USER:[e-mail]?p_cc=US&proxy_resi_ses_id=unique_job_id_101&proxy_resi_ses_time=60

Para manter exatamente o mesmo IP de saída em conexões consecutivas, você deve passar valores idênticos para ambos proxy_resi_ses_id e proxy_resi_ses_time em cada string de URL subsequente.

Exemplos de código

Os exemplos a seguir mostram como construir strings de conexão que aplicam segmentação geográfica junto com restrições de IP de proxy residencial fixo.

Python (Playwright)

from playwright.sync_api import sync_playwright

username = "USERNAME_abc12"
password = "PASSWORD"
endpoint = "hb.oxylabs.io"

# Target New York city and pin the residential IP for 30 minutes
geolocation = "p_cc=US&p_city=new_york"
sticky_proxy = "proxy_resi_ses_id=scrape_session_404&proxy_resi_ses_time=30"
browser_url = f"wss://{username}:{password}@{endpoint}?{geolocation}&{sticky_proxy}"

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(browser_url)
    page = browser.new_page()
    page.goto("https://ip.oxylabs.io/location")
    print(page.title())
    browser.close()

JavaScript (Playwright)

import { chromium } from "playwright";

const username = "USERNAME_abc12";
const password = "PASSWORD";
const endpoint = "hb.oxylabs.io";

// Target Texas state and pin the residential IP for 60 minutes
const geolocation = "p_state=texas&p_city=houston";
const sticky_proxy = "proxy_resi_ses_id=scrape_session_404&proxy_resi_ses_time=60";
const browserUrl = `wss://${username}:${password}@${endpoint}?${geolocation}&${sticky_proxy}`;

(async () => {
    const browser = await chromium.connectOverCDP(browserUrl);
    const page = await browser.newPage();
    await page.goto("https://ip.oxylabs.io/location");
    console.log(await page.title());
    await browser.close();
})();

JavaScript (Puppeteer)

import puppeteer from 'puppeteer';

(async () => {
    const username = 'USERNAME';
    const password = 'PASSWORD';
    const endpoint = 'hb.oxylabs.io';
    
    // Target Texas state and pin the residential IP for 60 minutes
    const geolocation = "p_state=texas&p_city=houston";
    const sticky_proxy = "proxy_resi_ses_id=scrape_session_404&proxy_resi_ses_time=60";
    const browserUrl = `wss://${username}:${password}@${endpoint}?${geolocation}&${sticky_proxy}`;

    const browser = await puppeteer.connect({
        browserWSEndpoint: browserUrl
    });
    const page = await browser.newPage();
    await page.goto('https://example.com');
    await browser.close();
})();