Quick Start

NinjasProxy is a high-performance proxy network with 72M+ residential IPs across 195 countries, dedicated datacenter subnets, and 4G/LTE mobile endpoints — all accessible through a single unified credential system. Whether you're scraping at scale, verifying ad placements, or automating account workflows, NinjasProxy routes your traffic through authentic, diverse IPs with sub-120 ms average latency.

All proxy types share the same authentication format and can be configured from your portal dashboard in seconds. Billing is per-GB with no commitments, so you only pay for what you use.

Prerequisites

Before you make your first request you need:

A NinjasProxy account — sign up free (no credit card required for the trial).
Your proxy username and API key, found under Dashboard → Credentials in the portal.
Any HTTP/HTTPS client: curl, Python requests, Node.js, Go's net/http, or a browser extension.

Your First Request

The fastest way to confirm your proxy is working is to route a request through the residential rotating endpoint and check which IP the outside world sees. Paste the command below into your terminal, replacing USERNAME and API_KEY with your real credentials.

curl --proxy "http://USERNAME:API_KEY@r.ninjasproxy.com:8080" \
     "https://api.ipify.org?format=json"

A successful response looks like {"ip":"203.0.113.47"} — an IP that belongs to a real residential ISP, not your own network. Every time you run the command without a session token you'll receive a fresh IP from the pool.

Tip: If you get a 407 Proxy Authentication Required error, double-check that your credentials don't contain special characters that need URL-encoding. For example, encode @ as %40 inside the proxy URL.

Using Any Language

The proxy endpoint speaks standard HTTP CONNECT and SOCKS5, so any HTTP client library works out of the box — no SDK required. Set the HTTP_PROXY / HTTPS_PROXY environment variables or pass the proxy URL directly to your client. See the integration guides for copy-paste examples:

Next Steps

Once your first request succeeds, explore the proxy types to understand which pool best fits your use case:

Residential proxies — real ISP IPs, city-level targeting, sticky sessions up to 60 minutes.
Datacenter proxies — dedicated subnets, unlimited bandwidth, lowest latency.
Mobile proxies — authentic 4G/LTE IPs from major carriers, highest trust scores.
Rotating proxies — new IP per request, ideal for large-scale data collection.