First integration
Confirm the credentials work with one curl, then layer on region and session options.
DOCS
Documentation
Every option, endpoint and limit you need to integrate, checked line by line against the backend — including the parts where we differ from other providers.
Check your credentials first
Fill in the username, password and gateway host from the console. The IP that comes back is your exit for this request. If it fails, start with the error reference.
curl -x http://USERNAME:PASSWORD@GATEWAY_HOST:58971 \
https://api.ipify.org?format=jsonWhich one are you
Scraping from code
Rotation strategy, pulling ports in bulk, and what to check when a request is refused.
Multi-account and ecommerce
One fixed exit per account, and passwordless ports so no credentials go into the browser.
All documentation
Your first request in five minutesGet credentials from the console, send one curl request, and confirm the exit IP is now in the region you asked for.Username option referenceAll eight username options: accepted values, ordering constraints, dependencies, and a full list of valid and invalid examples.Sticky sessions and rotationThe precise semantics of session and time, what a session binding actually binds, and how rotation really behaves.Extract APIExchange an API key for a batch of passwordless ip:port entries — every parameter, response format, error code and rate limit.Error referenceThe full meaning of every HTTP status, SOCKS5 reply code and API error code, plus where to look next.Limits and quotasDefault values for every limit: concurrency, connection rate, timeouts, account counts, whitelists, rate limits and risk-control thresholds.
Getting started
- Your first request in five minutesGet credentials from the console, send one curl request, and confirm the exit IP is now in the region you asked for.
- How the gateway worksThe steps a request passes through between your client and the target site, and what can reject you at each one.
- Choosing among four product linesBilling unit, targeting granularity and fit for dynamic residential, static residential, unlimited residential and datacenter.
- Verifying the proxy actually took effectSelf-checks for exit IP, geolocation, DNS behaviour and sticky sessions.
Product lines
- Dynamic residentialPer-gigabyte residential proxies with country-to-city targeting, operator ASN and OS targeting, and 1–120 minute sticky sessions.
- Static residentialResidential IPs bought by the unit and fixed for a 30-day lease — for account warming and anything that needs a stable IP.
- Unlimited residentialPort and bandwidth editions sold by port count or account-wide aggregate bandwidth and validity period, with no per-GB deduction.
- Datacenter proxiesHosting-provider IPs bought by the unit on 7/30/90-day leases — lowest latency and price, with renewals that keep the same IP.
- Unlimited residential · Port editionBuy by port count and validity. Payment triggers automatic delivery of real dedicated TCP ports, each capped at 6 Mbps and 20 concurrent connections.
- Media Parsing & Download APIUse your NextProxy customer API Key for nine media platforms, YouTube search and downloads, Telegram audio delivery and Shazam recognition, billed per call from your shared USD wallet.
- Access restrictions and usage rulesBlocked site categories, open ports, speed and concurrency limits for static residential, scenario ISP, premium residential, mobile, datacenter and IPv6 proxies. Check your target before you buy.
Proxy configuration
- Username option referenceAll eight username options: accepted values, ordering constraints, dependencies, and a full list of valid and invalid examples.
- Geographic targetingTargeting from country down to city and ASN — and how to tell which dimension has no inventory when it fails.
- Sticky sessions and rotationThe precise semantics of session and time, what a session binding actually binds, and how rotation really behaves.
- HTTP and SOCKS5How both protocols share one port, CONNECT tunnel behaviour, the limits of the SOCKS5 implementation, and how request headers are handled.
- IP whitelist and passwordless portsThe exact whitelist rules, how they relate to the Extract API, and which leg passwordless access actually skips.
Integration guides
- cURLA complete command reference for verifying the proxy, debugging options, and reading timing data with curl.
- PythonIntegration with requests, httpx, aiohttp and Scrapy, covering connection reuse, rotation control and retry strategy.
- Node.jsProxy integration for undici, axios, got and native fetch, with connection pool control and rotation.
- Go (Golang)Runnable examples for net/http Transport configuration, SOCKS5 dialling, connection pooling and rotation control.
- Java and PHPJava via HttpClient, OkHttp and Apache HttpClient; PHP via the cURL extension and Guzzle.
- Playwright and SeleniumConfiguring proxy authentication in browser automation frameworks, plus per-context proxies and rotation.
- Browsers and anti-detect browsersConfiguring proxies manually in Chrome and Firefox, and filling in the fields in AdsPower, BitBrowser and similar tools.
Programmatic API
- Extract APIExchange an API key for a batch of passwordless ip:port entries — every parameter, response format, error code and rate limit.
- Authentication and conventionsHow access and refresh tokens work, the Origin requirement, the uniform response envelope, and pagination conventions.
- Endpoint listEvery client API endpoint, grouped by function, with authentication requirements.
- Notifications and webhooksConfiguring traffic balance alerts, the requirements for four delivery channels, and the actual webhook payload.
Account and billing
- Proxy sub-accountsSub-account fields, the status machine, the two-layer traffic cap, and how to use them for team and workload isolation.
- Traffic accountingWhich bytes count, which don't, how the billing multiplier applies, and why your own numbers differ from the platform's.
- Usage statisticsWhich dimensions are queryable, how time boundaries are computed, how long data is retained, and how to export it yourself.
- Traffic CDKs and affiliate commissionTurning traffic allowance into transferable redemption codes, and how affiliate commission is earned, frozen and withdrawn.
Troubleshooting and limits
- Error referenceThe full meaning of every HTTP status, SOCKS5 reply code and API error code, plus where to look next.
- Limits and quotasDefault values for every limit: concurrency, connection rate, timeouts, account counts, whitelists, rate limits and risk-control thresholds.
- Troubleshooting flowSystematic diagnostic paths by symptom: can't connect, wrong IP, slow, or blocked by the target site.
- Target restrictionsWhich target addresses and ports are refused, the fixed hostname resolution behaviour, and the practical consequences of no UDP support.
Still not working?
Anything the docs miss, open a ticket — engineering will look at the exact error and timestamp.