Residential Proxies

Residential proxies are currently exposed as assigned residential endpoints in your account. Use the exact HTTP endpoint shown in the portal for the residential IP you want to connect through.

Public docs use placeholders on purpose. Do not invent or hard-code gateway hostnames — copy the exact endpoint from Portal → Proxy IPs.

Current product behavior: Residential endpoints are treated as direct/static assigned endpoints in the portal. If you need rotating behavior or per-request routing controls, use the dedicated rotating gateway docs.

Find your endpoint

1. Open Portal → Proxy IPs.
2. Find the Residential IPv4 or Residential IPv6 section.
3. Copy the HTTP endpoint shown next to the assigned IP you want to use.

Authentication

Username + API key

Use your portal username and API key directly in the proxy URL.

http://USERNAME:API_KEY@<RESIDENTIAL_HTTP_ENDPOINT>

IP whitelist

If your server IP is whitelisted in the portal, you can connect without embedding credentials in the URL.

http://<RESIDENTIAL_HTTP_ENDPOINT>

Code examples

curl

curl -x "http://<USERNAME>:<API_KEY>@<RESIDENTIAL_HTTP_ENDPOINT>"   "https://ip.ninjasproxy.com/"

Axios

import axios from "axios"

const proxyUrl = new URL("http://<USERNAME>:<API_KEY>@<RESIDENTIAL_HTTP_ENDPOINT>")

const response = await axios.get("https://ip.ninjasproxy.com/", {
  proxy: {
    protocol: proxyUrl.protocol.replace(":", ""),
    host: proxyUrl.hostname,
    port: Number(proxyUrl.port),
    auth: {
      username: proxyUrl.username,
      password: proxyUrl.password,
    },
  },
  timeout: 20000,
})

console.log(response.data)

Next Steps

• Datacenter proxies — assigned static datacenter endpoints
• Mobile proxies — assigned mobile-network endpoints
• Rotating proxies — use gateway endpoints for routing controls and sticky sessions
• Authentication — username + API key and IP whitelist setup