Residential Proxies
When you don't need anti-bot bypass or rendering — just a clean residential IP to fetch a URL — use direct proxy credentials or the proxy fetch endpoint. Traffic is billed by bandwidth at $2.00 / GB with no monthly commitment for proxy bandwidth itself.
:::info Access Direct proxy URLs and credentials are locked on the free trial. Trial users can still use Web Unlocker and BaaS — residential proxy is applied automatically behind those products. Unlock direct access by activating PAYG (minimum $5 top-up) or subscribing to a paid plan. The dashboard shows an Activate PAYG or Plan CTA while locked. :::
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 — proxy is embedded automatically. See Proxies & geo-targeting.
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.