Nym Privacy Proxy — Full User Guide
A complete, beginner‑to‑advanced guide for everyone — non‑technical users, developers, journalists/activists, founders, marketers, researchers, and no‑code makers — to get real, practical privacy today using the Nym Privacy Proxy (Apify‑based beta).
This document is intentionally detailed and step‑by‑step, so even someone with zero technical background can follow it end‑to‑end.
Official Links (Start Here)
These are the only official and authoritative links for the Nym Privacy Proxy app:
-
Live App / API Base URL
https://nym-proxy.vercel.app -
Health Check (service status)
https://nym-proxy.vercel.app/v1/health -
Main Proxy Endpoint
POST https://nym-proxy.vercel.app/v1/proxy -
Official GitHub Repository (docs + source)
https://github.com/BikramBiswas786/nym-proxy-mvp -
API Metadata (root response)
https://nym-proxy.vercel.app/
Important: This is a backend privacy API, not a website UI. Seeing JSON at the root URL is expected and confirms the service is live.
Table of Contents
-
What this app does (plain English)
-
Why privacy matters (real‑world examples)
-
Quick start — easiest possible test (5 minutes)
-
Non‑technical users guide (Zapier, Google Sheets, browser tools)
-
Everyday use cases (non‑tech & business)
-
Developer guide (Node.js, Python, curl)
-
Advanced developer patterns & automation
-
Journalists, activists & researchers (high‑risk scenarios)
-
No‑code builders & founders (Bubble, Webflow, Adalo)
-
Extended use‑case library (ideas you can build today)
-
Security, keys & best practices
-
Troubleshooting & FAQ
-
Roadmap: today vs future Nym mixnet
1. What this app does (Plain English)
In one sentence:
Nym Privacy Proxy lets you fetch any website or API without exposing your real IP address.
When you normally access a site:
You → Website (your IP is visible)
When you use this app:
You → Nym Privacy Proxy → Website (your IP is hidden)
The website only sees a cloud proxy IP, not:
-
your home IP
-
your office IP
-
your country/city
-
your personal device
2. Why privacy matters (Real‑world examples)
Without privacy tools:
-
Competitor sites detect and block your IP
-
Research targets can identify and profile you
-
Journalists expose themselves to surveillance
-
Activists reveal location patterns
-
Developers leak infrastructure details
With Nym Privacy Proxy:
-
Requests are separated from your identity
-
Safer research and monitoring
-
Reduced tracking and fingerprinting
-
Future‑proof path to strong metadata privacy
This is not theoretical privacy — it works today.
3. Quick Start — The Easiest Test (5 Minutes)
This works for anyone, even first‑time users.
Step 1: Open a terminal
-
Linux / macOS: Terminal
-
Windows: PowerShell
-
Android: Termux
Step 2: Paste and run
curl -X POST https://nym-proxy.vercel.app/v1/proxy \
-H "Authorization: Bearer test_key_123" \
-H "Content-Type: application/json" \
-d '{"url": "https://httpbin.org/ip"}'
Step 3: Read the response
-
The IP shown is NOT your real IP
-
That means the proxy is working
You are now using private network routing.
4. Non‑Technical Users Guide (No Coding Required)
A. Zapier / Make.com (Automation users)
Who this is for:
-
Marketers
-
Business owners
-
Analysts
-
Growth teams
Example use case:
Automatically check competitor pricing daily without revealing your company IP.
Step‑by‑step:
-
Create a Zap → choose any trigger (Schedule / Google Sheet / Webhook)
-
Add Action → Webhooks → POST
-
URL:
https://nym-proxy.vercel.app/v1/proxy
- Headers:
Authorization: Bearer test_key_123
Content-Type: application/json
- Body (JSON):
{ "url": "{{target_url}}" }
- Save output to Sheet / Slack / Email
Result: competitor only sees proxy IP.
B. Google Sheets (Privacy inside spreadsheets)
Use cases:
-
Price tracking
-
SEO checks
-
Public data monitoring
Setup:
function PRIVACY_FETCH(url) {
var payload = JSON.stringify({ url: url });
var options = {
method: 'post',
headers: { 'Authorization': 'Bearer test_key_123' },
contentType: 'application/json',
payload: payload
};
var response = UrlFetchApp.fetch('https://nym-proxy.vercel.app/v1/proxy', options);
return JSON.parse(response.getContentText()).result.body;
}
Usage:
=PRIVACY_FETCH("https://httpbin.org/ip")
5. Everyday Use Cases (Non‑Tech & Business)
-
Competitor intelligence (pricing, offers, landing pages)
-
SEO & SERP monitoring without location leaks
-
Market research without revealing identity
-
Brand monitoring & reputation tracking
-
Safe API testing from shared offices
-
Anonymous data collection for reports
6. Developer Guide
Node.js
const res = await fetch('https://nym-proxy.vercel.app/v1/proxy', {
method: 'POST',
headers: {
'Authorization': 'Bearer test_key_123',
'Content-Type': 'application/json'
},
body: JSON.stringify({ url: 'https://api.example.com/data' })
});
const data = await res.json();
console.log(data);
Python
import requests
r = requests.post(
'https://nym-proxy.vercel.app/v1/proxy',
headers={'Authorization': 'Bearer test_key_123'},
json={'url': 'https://httpbin.org/ip'}
)
print(r.json())
curl (servers, scripts)
curl -X POST https://nym-proxy.vercel.app/v1/proxy \
-H "Authorization: Bearer test_key_123" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'
7. Advanced Developer Patterns
-
Background workers & cron jobs
-
Web scrapers with IP separation
-
AI agents fetching external data
-
Wallets and dApps hiding RPC origin
-
Monitoring bots with rate‑limit safety
Tip: cache responses to reduce repeated requests.
8. Journalists, Activists & Researchers
Why this matters:
-
Protects source research
-
Avoids IP‑based targeting
-
Reduces surveillance surface
Best practices:
-
Use from a backend or temporary VM
-
Strip cookies & tracking headers
-
Separate identity from research accounts
This tool is stronger than basic VPN usage for many workflows and becomes far stronger once the Nym mixnet backend is enabled.
9. No‑Code Builders & Founders
Platforms:
-
Bubble
-
Webflow
-
Adalo
Build ideas:
-
Anonymous feedback systems
-
Private data dashboards
-
Competitor tracking SaaS
-
Research tools for analysts
Config:
-
Bearer auth
-
JSON body
{ "url": "https://target.site" }
10. Extended Use‑Case Library (Ideas)
-
Privacy‑first SaaS MVPs
-
Anonymous web monitoring services
-
Secure data collection tools
-
AI agents with privacy by default
-
Academic research pipelines
-
Web3 or crypto analytics without IP leaks
-
Internal company monitoring without revealing infra
11. Security, Keys & Best Practices
-
Never expose keys in frontend code
-
Use environment variables
-
Rotate keys regularly
-
Log minimal metadata
12. Troubleshooting & FAQ
Q: I only see JSON in browser
A: Correct — this is an API, not a website.
Q: 401 / 403 error
A: Check Authorization header format.
Q: Site blocks proxy IPs
A: Some sites block clouds. Future Nym mixnet solves this.
13. Roadmap: Today vs Future
Today:
-
Cloud IP anonymization
-
Simple integration
-
Real privacy benefits
Future:
-
Nym mixnet (5‑hop routing)
-
Cover traffic
-
Strong metadata protection
-
No integration changes needed
Official project by: Bikram Biswas — Nym Privacy Proxy (beta)