Tipo de dispositivo y selección de proxy

Descubre cómo usar los parámetros de ubicación 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 dirigir sus sesiones automatizadas de Headless Browser a regiones geográficas específicas y controlar el uso de la IP de su proxy.

Parámetros de geolocalización

Puede orientar 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 (por ejemplo, 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 (por ejemplo, berlin, los_angeles). También debe especificar cualquiera de 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 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 ámbito del país.

Estado (solo EE. UU.)

p_state	Nombre del estado de EE. UU. en minúsculas (por ejemplo, texas, ohio). Consulte 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 (proxies persistentes)

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 en intentos continuos de conexión del navegador incluyendo los 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 fijada la IP de salida del proxy residencial. Mín. – 1 minuto, máx. – 1440 minutos (24 horas).	entero

# Ejemplo: Fije una IP con base en EE. UU. durante 60 minutos
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 apliquen segmentación geográfica junto con restricciones de IP de proxy residencial persistente.

Python (Playwright)

from playwright.sync_api import sync_playwright

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

# Dirija la ciudad de Nueva York y fije la IP residencial durante 30 minutos
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";

// Dirija el estado de Texas y fije la IP residencial durante 60 minutos
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';
    
    // Dirija el estado de Texas y fije la IP residencial durante 60 minutos
    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();
})();