Skip to main content

Proxies & Geo-Targeting

OmniScrape routes requests through a pool of residential IPs. You can let us pick automatically, target a specific country, or — once unlocked — connect through direct proxy credentials over HTTP, HTTPS, or SOCKS5.

:::info Trial vs direct proxy

On the free trial, embedded proxy works automatically on Web Unlocker and BaaS. Direct proxy URLs, the dashboard credential panel, and /v1/proxy/fetch require PAYG (minimum $5 top-up) or a paid plan.

:::

Automatic (default)​

If you omit proxy, we choose a healthy IP for you. This is the right choice most of the time.

Geo-targeting a country​

To see a site as a visitor from a specific country, use residential:<country-code> with an ISO 3166-1 alpha-2 code.


{
  "url": "https://shop.example.com",
  "proxy": "residential:de"
}

We support 217 countries with country-level targeting. Common codes: us, gb, de, fr, ca, au, jp, br, in, nl, sg, id. See Residential Proxies for gateway connection details.

Direct proxy gateway​

Unlocked accounts get credentials in Dashboard → Proxies for proxy.omniscrape.io:

| Protocol | Port |

|---|---|

| HTTP | 8080 |

| HTTPS | 8443 |

| SOCKS5 | 1080 |

Append _country-<CC> to the proxy username for the same country targeting as residential:<cc> on the scrape API. Rotate the password from the dashboard or POST /auth/rotate-proxy-credentials.

Why geo matters​

Prices, product availability, language, and even page layout often change by country. Geo-targeting lets you collect the exact regional view you need — essential for price monitoring and market research.

Sticky IPs​

By default each request may use a different IP. To keep the same IP (and cookies) across multiple requests — for paginated crawls or logged-in flows — use a session.


{
  "url": "https://shop.example.com/de/page/1",
  "proxy": "residential:de",
  "session_id": "de-shop-crawl"
}

Raw proxy fetch (no unlocking)​

If you only need a residential IP to fetch a non-protected URL — without JS rendering or anti-bot solving — use the dedicated proxy fetch endpoint, billed by bandwidth ($2.00/GB) instead of per request. Requires PAYG or a plan (not available on trial).