Geolocalización y selección de Proxies

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

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

Parámetros de geolocalización

Puedes dirigirte a 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., US, 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 la ciudad escrito en minúsculas (p. ej., berlin, los_angeles). También debes especificar ya sea p_cc o p_state.

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

El targeting a nivel de ciudad funciona como preferencia de mejor esfuerzo. Si el grupo de proxies residenciales 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). Consulta la lista completa de estados admitidos.

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 (proxies persistentes)

De forma predeterminada, la puerta de enlace proxy asigna una nueva IP de salida a cada sesión única de conexión del navegador. Como alternativa, puedes fijar una IP de salida residencial específica en intentos continuos de conexión del navegador incluyendo el 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 3 a 36 caracteres.	cadena
proxy_resi_ses_time	Número de minutos para mantener fija 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

To maintain the exact same exit IP across consecutive connections, you must pass identical values for both proxy_resi_ses_id y proxy_resi_ses_time in every subsequent URL string.

Ejemplos de código

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

Python (Playwright)

from playwright.sync_api import sync_playwright

username = "USERNAME_abc12"
password = "PASSWORD"
endpoint = "ubc.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 = "ubc.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 = 'ubc.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();
})();