NodeMaven - 🚀 Professional Proxy API 🚀

Enterprise-Grade Residential & Mobile Proxy API - Global coverage, sticky sessions, and advanced geo-targeting for developers and businesses.

🎯 Why NodeMaven?

• 🌍 164+ Countries - Global proxy coverage with 1,455+ regions and 6,811+ cities
• 🏠 Residential IPs - Real ISP addresses from 63,726+ providers worldwide
• 📱 Mobile Proxies - 4G/5G connections for mobile-specific applications
• 🔒 HTTP & SOCKS5 - Full protocol support for any use case
• 📍 Precision Targeting - Country, region, city, and ISP-level targeting
• 🔄 Sticky Sessions - Maintain same IP for session duration
• ⚡ 99.9% Uptime - Enterprise-grade infrastructure and reliability
• 📊 Real-time Analytics - Monitor usage, performance, and success rates

🧪 SDK Development Status

All our SDKs are currently in active testing phase with basic functionality implemented:

🐍 Python - In Testing

from nodemaven import Client

client = Client()
proxy = client.getProxyConfig({'country': 'US'})

🟢 JavaScript/Node.js - In Testing

const { NodeMavenClient } = require('@nodemaven/sdk');

const client = new NodeMavenClient();
const proxy = await client.getProxyConfig({ country: 'US' });

🟣 PHP - In Testing

use NodeMaven\Client;

$client = new Client();
$proxy = $client->getProxyConfig(['country' => 'US']);

🔷 Go - In Testing

client, _ := nodemaven.NewClient(&nodemaven.Config{})
proxy, _ := client.GetProxyConfig(&nodemaven.ProxyOptions{Country: "US"})

🚀 Quick Start

Step 1: Get Your API Key 🔑

1. Sign up: NodeMaven Dashboard
2. Get API key: From your dashboard profile

Step 2: Test an SDK

🐍 Python Testing

cd python
python -m venv venv
source venv/bin/activate  # Linux/Mac
# or venv\Scripts\activate  # Windows

pip install -r requirements.txt
export NODEMAVEN_APIKEY="your_api_key_here"
python quick_test.py

🟢 JavaScript Testing

cd javascript
npm install
export NODEMAVEN_APIKEY="your_api_key_here"
node quick_test.js

🟣 PHP Testing

cd php
composer install
export NODEMAVEN_APIKEY="your_api_key_here"
php quick_test.php

🔷 Go Testing

cd go
go mod tidy
export NODEMAVEN_APIKEY="your_api_key_here"
go run examples/basic_usage.go

📁 Repository Structure

nodemaven-proxy/
├── 🐍 python/                     # Python SDK (Testing)
│   ├── src/nodemaven/             # Core package
│   ├── examples/                  # Basic examples
│   └── quick_test.py              # Setup test
│
├── 🟢 javascript/                  # JavaScript SDK (Testing)
│   ├── src/                       # Core files
│   ├── examples/                  # Basic examples
│   └── quick_test.js              # Setup test
│
├── 🟣 php/                         # PHP SDK (Testing)
│   ├── src/                       # Core classes
│   ├── examples/                  # Basic examples
│   └── quick_test.php             # Setup test
│
├── 🔷 go/                          # Go SDK (Testing)
│   ├── nodemaven/                 # Go package
│   ├── examples/                  # Basic examples
│   └── README.md                  # Go-specific docs
│
└── README.md                      # This file

💡 Basic Usage Examples

🔄 IP Rotation

for i in range(3):
    proxy = client.getProxyConfig({'country': 'US'})
    # Each call gets a different IP

📌 Sticky Sessions

const sessionId = 'session_' + Date.now();
const proxy = await client.getProxyConfig({ 
    country: 'US', 
    session: sessionId 
});
// Maintains same IP for session

🌍 Geo-Targeting

$proxy = $client->getProxyConfig([
    'country' => 'US',
    'city' => 'New York'
]);

🧪 Testing & Setup

Each SDK includes a quick test to verify setup:

# Expected output for all tests:
✅ API Key found
✅ Connected! User: your@email.com  
✅ Proxy credentials obtained
✅ Test complete - SDK working!

⚠️ Development Status

Important: These SDKs are currently in testing phase and not ready for production use.

• ✅ Basic functionality implemented
• 🧪 Currently undergoing testing
• 📝 Documentation being refined
• 🔧 APIs may change

For production use, please check back later or contact support.

🚨 Common Issues

Issue	Solution
No API key found	Set NODEMAVEN_APIKEY environment variable
Connection failed	Check API key validity in dashboard
Import errors	Ensure dependencies are installed

📚 Resources

• 🎯 Dashboard: dashboard.nodemaven.com
• 📖 API Docs: Complete reference
• 💬 Support: @node_maven
• 🐛 Issues: GitHub Issues

💰 Pricing

Plan	Monthly	Traffic	Features
Starter	$50	5GB	All countries, HTTP/SOCKS5
Professional	$200	25GB	Advanced targeting
Enterprise	Custom	Unlimited	Dedicated support

View Pricing • Free Trial

📄 License

MIT License - see LICENSE file for details.

---

🚀 Get Started • 📖 Documentation • 💬 Support

Made with ❤️ by the NodeMaven Team