NikaProxy — Examples

Runnable starter code for the NikaProxy residential proxy + scrape API.

Real code that runs. Paste your API key + proxy password, hit go. Every snippet has been tested against the live API.

Pick your stack

Language	Folder	Notable
Python	python/	requests + httpx
Node.js	nodejs/	fetch + axios
Go	go/	net/http
PHP	php/	cURL
curl	curl/	Shell one-liners — fastest way to sanity-check

Each folder has 3 examples:

1. basic_proxy — minimal HTTP/SOCKS5 proxy usage. The simplest possible "make a request through NikaProxy" snippet.
2. scrape_api — the REST scrape API. Send a URL, get JSON back, no proxy plumbing needed. Best for one-shot scraping.
3. sticky_session — bind a session ID so consecutive requests reuse the same residential exit IP. Required for multi-request flows like login → scrape protected page.

Get credentials

1. Sign up at nikaproxy.com — 100 MB free credit
2. Open the dashboard → API & Credentials page
3. Copy two things:
   • API key — used as the username on the proxy AND as Authorization: Bearer on the scrape API
   • Proxy password — used only on the HTTP/SOCKS5 proxy paths

Every example reads these from environment variables so you never commit them by accident:

export NIKA_API_KEY="nka_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export NIKA_PROXY_PASSWORD="px_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Proxy URL anatomy

http://<api-key>-country-<CC>-session-<id>:<password>@proxy.nikaproxy.com:8080
       └──── username with optional modifiers ────┘  └──── credentials ────┘  └── gateway ──┘

Optional username modifiers (mix and match, separated by -):

Token	What it does
country-US	Force a US exit (any ISO-3166 alpha-2 code; default = auto)
session-mysession	Sticky session ID — same value → same exit IP
session-mysession-min-30	Sticky for 30 minutes (5/10/15/20/60 supported)
profile-chrome_131	TLS Pro / Ultra — pin the TLS fingerprint profile
coord-win11	TLS Ultra — coordinate L4 + L7, force a Windows 11 exit
coord-mobile	TLS Ultra — force a mobile exit (android / iOS)

SOCKS5 lives at :1080 on the same hostname with the same auth pattern.

License

MIT — fork, modify, copy into your own SDK, do whatever's useful.

Need help?

• Discord: discord.gg/xeeDxZMRh — community + dev questions
• Telegram: @Nikaproxy_support — 1-on-1 support
• Docs: nikaproxy.com/docs
• Issues against this repo: bug reports + sample requests welcome