地理位置与代理选择

了解如何使用位置参数从特定位置访问网页数据。

直接将地理位置和代理路由参数添加到 WebSocket 连接 URL，将自动化无头浏览器会话路由到目标地理区域，并控制代理 IP 的使用。

地理位置参数

您可以使用三个主要查询参数按国家、州或城市定位特定地理位置。

国家

p_cc	2 位国家代码（例如， US, DE, FR）。如果未指定国家/地区，将根据可用性自动分配。

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

城市

p_city	使用小写的城市名称（例如， berlin, los_angeles）。还必须同时指定以下任一项： p_cc 或 p_state.

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

城市级定位采用 尽力而为的优先级。如果住宅代理池中没有请求的精确位置可用代理，则会自动回退到国家范围。

州（仅限美国）

p_state	以小写形式填写美国州名（例如， texas, ohio）。查看完整的 支持的州列表.

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

注意： 如果 p_state 和 p_cc 两者都指定， p_state 将优先，并且 p_cc 将被忽略。

代理选择（粘性代理）

默认情况下，代理网关会为每个唯一的浏览器连接会话分配一个新的出口 IP。或者，您可以通过添加以下参数，在连续的浏览器连接尝试中固定一个特定的住宅出口 IP： proxy_resi_ses_id 和 proxy_resi_ses_time 参数的访问权限。

参数	描述	类型
proxy_resi_ses_id	由 3 到 36 个字符组成的字母数字会话跟踪器名称。	字符串
proxy_resi_ses_time	保持固定的住宅代理出口 IP 的分钟数。最少 1 分钟，最多 1440 分钟（24 小时）。	整数

# 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

要在连续连接中保持完全相同的出口 IP，您必须为以下两项传递相同的值： proxy_resi_ses_id 和 proxy_resi_ses_time 并在后续每个 URL 字符串中保持一致。

代码示例

以下示例展示如何构造同时应用地理定位和粘性住宅代理 IP 约束的连接字符串。

Python（Playwright）

from playwright.sync_api import sync_playwright

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

# 定位纽约市并将住宅 IP 固定 30 分钟
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();
})();