Geolocalización y selección de proxy

Descubre cómo usar los parámetros de ubicación de Oxylabs Agent Browser para acceder a datos web desde ubicaciones específicas.

Use los parámetros de geolocalización y enrutamiento de proxy directamente en la URL de conexión WebSocket para enrutar sus sesiones automatizadas de Agent Browser a través de regiones geográficas específicas y controlar el uso de su IP de proxy.

Parámetros de geolocalización

Puede dirigir ubicaciones geográficas específicas por país, estado o ciudad usando tres parámetros de consulta principales.

País

p_cc	Código de país de 2 letras (p. ej., EE. UU., DE, FR). Si no se especifica ningún país, se asigna automáticamente según la disponibilidad.

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

Ciudad

p_city	Nombre de ciudad escrito en minúsculas (p. ej., berlin, los_angeles). También debe especificar ya sea p_cc o p_state.

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

La segmentación a nivel de ciudad funciona como una preferencia de mejor esfuerzo. Si el grupo de proxy residencial no tiene un proxy disponible en la ubicación exacta solicitada, cambia automáticamente al alcance del país.

Estado (solo EE. UU.)

p_state	Nombre del estado de EE. UU. en minúsculas (p. ej., texas, ohio). Vea la lista completa de estados compatibles.

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

Nota: Si p_state y p_cc se especifican ambos, p_state tiene prioridad y p_cc se ignora.

Selección de proxy (sticky proxies)

De forma predeterminada, la puerta de enlace de proxy asigna una nueva IP de salida a cada sesión única de conexión del navegador. Como alternativa, puede fijar una IP de salida residencial específica a lo largo de intentos continuos de conexión del navegador incluyendo la proxy_resi_ses_id y proxy_resi_ses_time parámetros.

Parámetro	Descripción	Tipo
proxy_resi_ses_id	Nombre de seguimiento de sesión alfanumérico de entre 3 y 36 caracteres.	cadena
proxy_resi_ses_time	Número de minutos para mantener fijada la IP de salida del proxy residencial. Mín. – 1 minuto, máx. – 1440 minutos (24 horas).	entero

# 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 mantener exactamente la misma IP de salida en conexiones consecutivas, debe pasar valores idénticos para ambos proxy_resi_ses_id y proxy_resi_ses_time en cada cadena de URL posterior.

Ejemplos de código

Los siguientes ejemplos muestran cómo construir cadenas de conexión que aplican segmentación geográfica junto con restricciones de IP de proxy residencial persistente.

Python (Playwrigth)

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();
})();