NebulaProxy
Gateway Online

Rotate your egress IP
on every request

NebulaProxy is a rotating proxy API gateway. Send a request, get a fresh IP from one of six countries, and stream the response back — all through a single endpoint.

🌍 6 countries ⚡ Live streaming 🍪 Cookies & headers
0
Requests
100%
Success rate
—
Avg latency
0
Regions seen
Why NebulaProxy

Everything you need to rotate traffic

A single API endpoint that handles providers, IPs, headers, and streaming for you.

🛡️

Multi-provider fallback

If one upstream proxy fails, NebulaProxy automatically retries through another — no downtime.

🌍

Six-country rotation

Rotate egress across the United States, United Kingdom, Germany, Poland, Spain, and Japan.

🍪

Cookies & headers

Pass custom cookies and headers straight through to the target — full control over the request.

⚡

Live streaming

Stream responses as they arrive with SSE, so long downloads don't block your client.

📁

Binary-safe

Images, files, and binary payloads pass through untouched with base64 support.

🐍

Any language

Use cURL, Python, Node.js, or anything that speaks HTTP. One endpoint, no SDK required.

Playground

Test the proxy live

Send a request through the gateway and inspect the full response.

request tester
Ready
Fill the fields and press Send to see the response.
Documentation

API reference

Everything you need to integrate NebulaProxy into your app.

Endpoints

MethodEndpointDescription
POST/api/proxyProxy a request through a rotating IP
GET/api/proxy/ipGet your current egress IP

Request parameters

FieldTypeRequiredDescription
urlstringyesThe target URL to fetch
methodstringnoHTTP method (default GET)
proxy_countrystringnoTwo-letter country code (or "auto")
retriesnumbernoRetry attempts on failure
headersobjectnoCustom headers to forward
cookiesobjectnoCookies to attach
bodystringnoRequest body (for POST/PUT/PATCH)
bodyIsBase64booleannoWhether the body is base64-encoded
stickybooleannoKeep the same IP across requests

Examples

cURL
curl -X POST https://your-worker.dev/api/proxy \
  -H "Content-Type: application/json" \
  -d '{"url":"https://api.ipify.org?format=json","proxy_country":"us"}'
Python
import requests

r = requests.post("https://your-worker.dev/api/proxy", json={
    "url": "https://api.ipify.org?format=json",
    "proxy_country": "us"
})
print(r.json())
Node.js
const res = await fetch("https://your-worker.dev/api/proxy", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://api.ipify.org?format=json", proxy_country: "us" })
});
console.log(await res.json());

Response

JSON
{
  "status": 200,
  "statusText": "OK",
  "headers": { "content-type": "application/json" },
  "data": { "ip": "198.105.121.200" },
  "data_b64": null,
  "binary": false,
  "size": 24,
  "proxyCountry": "us",
  "attempt": 1,
  "success": true,
  "elapsed_ms": 812,
  "elapsed_sec": 0.812
}
Settings

Configuration

Tune your gateway preferences and manage admin access.

⚙️ General

Sticky sessions
Reuse the same IP across requests
Streaming (SSE)
Stream responses as they arrive
Dark theme
Toggle between dark & light
Default country
Used when no country is specified

🔐 Admin login

Sign in to manage proxies, view live stats, and rotate keys.

🔑 API keys

Rotate or revoke gateway keys. Admin access required.

Demo build — admin features require a connected backend.