WS Geo-Targeting

Country-routed sessions

Pass ?country=XX (ISO 3166-1 alpha-2) when connecting to route your session through a residential proxy in that country:

wss://api.anakin.io/v1/browser-connect?country=GB

Aligned fingerprint signals

When you pass ?country=, the browser's timezone, locale, language, and Accept-Language all match the proxy's country. Anti-bot systems compare these against the IP — a UK IP that reports UTC and en-US is an obvious bot signal. With ?country=GB every signal lines up.

What websites see for ?country=GB:

Supported countries

Per-country timezone and locale defaults:

Country codes not in this list still route through a residential proxy in that country (proxy availability permitting), but timezone and locale fall back to the browser's defaults (UTC and en-US). Open a support ticket if you need a country added to the alignment table.

If ?country= is omitted, the session is not geo-pinned: it does not go through a residential proxy, and timezone/locale stay at the browser defaults (UTC, en-US). Pass a country whenever the target site cares about where you are coming from.

Checking your exit IP: some IP-echo services (ipinfo.io, api.ipify.org, httpbin.org) block residential proxy ranges and fail with ERR_TUNNEL_CONNECTION_FAILED — that is the echo service, not your session. Use https://lumtest.com/myip.json instead.

Example: GB session

import asyncio
from playwright.async_api import async_playwright

async def main():
    async with async_playwright() as p:
        browser = await p.chromium.connect_over_cdp(
            "wss://api.anakin.io/v1/browser-connect?country=GB",
            headers={"X-API-Key": "your_api_key"},
        )
        page = browser.contexts[0].pages[0]

        # IP, timezone, language all align to GB
        info = await page.evaluate("""
            ({
                tz: Intl.DateTimeFormat().resolvedOptions().timeZone,
                lang: navigator.language,
                offset: new Date().getTimezoneOffset(),
            })
        """)
        print(info)  # {tz: 'Europe/London', lang: 'en-GB', offset: 0}

        await browser.close()

asyncio.run(main())

const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.connectOverCDP(
    'wss://api.anakin.io/v1/browser-connect?country=GB',
    { headers: { 'X-API-Key': 'your_api_key' } }
  );
  const page = browser.contexts()[0].pages()[0];

  const info = await page.evaluate(() => ({
    tz: Intl.DateTimeFormat().resolvedOptions().timeZone,
    lang: navigator.language,
    offset: new Date().getTimezoneOffset(),
  }));
  console.log(info);  // {tz: 'Europe/London', lang: 'en-GB', offset: 0}

  await browser.close();
})();

Sticky exit IP within a session

A single session keeps the same exit IP for its duration. Reconnecting issues a fresh proxy by default — pair with Saved Sessions if you need IP stickiness across reconnects (the saved session's proxy is preserved).