Residential Proxies
When you don't need anti-bot bypass or rendering — just a residential IP — use direct credentials or /v1/proxy/fetch. Billed at $2.00 / GB, no monthly minimum.
Direct credentials need PAYG or a paid plan. On trial, proxy is embedded in Web Unlocker and BaaS automatically.
Protocols & gateway
Connect through proxy.omniscrape.io with dedicated credentials from Dashboard → Proxies:
| Protocol | Port | Example |
|---|---|---|
| HTTP | 8080 | http://USER:PASS@proxy.omniscrape.io:8080 |
| HTTPS | 8443 | https://USER:PASS@proxy.omniscrape.io:8443 |
| SOCKS5 | 1080 | socks5://USER:PASS@proxy.omniscrape.io:1080 |
Append _country-<CC> to the username for country targeting (ISO 3166-1 alpha-2, e.g. os_user_country-DE). We support 217 countries — see the marketing product page for coverage details.
Rotate the proxy password anytime from the dashboard or via POST /auth/rotate-proxy-credentials (session auth). The username stays the same.
Proxy fetch endpoint
For HTTP clients that prefer an API over a proxy URL:
POST https://api.omniscrape.io/v1/proxy/fetch
curl -X POST https://api.omniscrape.io/v1/proxy/fetch \
-H "X-API-Key: $OMNISCRAPE_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com",
"method": "GET",
"headers": { "Accept-Language": "en-US" }
}'
Trial accounts receive 402 with code PROXY_LOCKED on this endpoint. See the full proxy fetch reference.
Request fields:
| Field | Type | Default | Description |
|---|---|---|---|
url | string | — | Required. Target URL. |
method | string | GET | HTTP method. |
headers | object | {} | Headers to send to the target. |
Response:
{
"success": true,
"data": {
"status_code": 200,
"headers": { "content-type": "text/html" },
"body": "<!DOCTYPE html>...",
"bandwidth": { "bytes": 48213, "gb": 0.00004, "cost": 0.00009 }
}
}
Geo-targeting on Web Unlocker
Use the proxy parameter on POST /v1/scrape (residential:<country>) for geo-targeted unlocking. This works on the free trial. You can also control how IPs rotate per request with the third colon-segment:
| Value | Behaviour |
|---|---|
residential:us | US IP, sticky (same IP per session) |
residential:us:rotate | US IP, fresh on every request |
residential:us:smart | US IP, reuse until blocked then auto-swap |
See Proxies & geo-targeting and Proxy Rotation Modes.
Billing
Residential proxy traffic is billed by bandwidth at $2.00 / GB (request + response bytes). The bandwidth block in every response shows exact bytes and cost. See Pricing.
Proxy fetch vs the scrape API
| Use direct proxy / proxy fetch when… | Use the scrape API when… |
|---|---|
| You just need a residential IP | You want anti-bot bypass handled for you |
| The target isn't protected | The site uses Cloudflare / DataDome / etc. |
| You want the raw, untouched response | You want JS rendering, extraction, or screenshots |
| You're billing-sensitive on simple fetches | You want pay-for-success unlocking |
Direct proxy access gives you the IP and the raw bytes — challenge solving and JavaScript rendering are features of the Web Unlocker scrape API.