Skip to main content
Build NodeMaven proxy configurations and manage your account from Python, Rust, or Go. The NodeMaven SDKs turn settings in your code into the proxy username and connection details the gateway expects. Choose a location, select Residential or Mobile, add a session, and pass the resulting configuration to your HTTP client or browser. The SDKs also provide an account API client for traffic balance, usage statistics, locations, sub-users, and whitelisted IPs.

​
Choose your SDK

Choose the language your application already uses. The three libraries cover the same core tasks, with methods and error handling suited to each language. Additional HTTP clients and browser drivers may have their own runtime requirements.

​
What the SDKs help with

  • Build proxy settings. Set a country, region, city, carrier, proxy pool, filter, or session without assembling the username by hand.
  • Catch configuration mistakes locally. Unknown parameter names, empty values, and invalid formatting produce an error before you connect.
  • Use your existing client. Get a proxy URL, client-specific configuration, or separate browser authentication fields.
  • Check a connection. Open an HTTP CONNECT tunnel and read the gateway’s response before starting a larger job.
  • Work with the account API. Read traffic and locations, retrieve statistics, and manage supported account resources.
Creating a proxy object does not make a request. Your HTTP client or browser sends application traffic and controls its timeouts, connection reuse, retries, and concurrency. Connection checks and account API calls make network requests only when you call them.

​
Product coverage

These guides cover the Residential and Mobile proxy gateway. Both use gate.nodemaven.com; type="mobile" selects the mobile pool. ISP proxies, the Scraping Browser, and the LLM API have separate connection or API workflows. Do not apply the gateway examples to them unchanged. Some dashboard options are not available through the SDK proxy builder. In the versions covered by these guides, zip and norotate are not accepted parameters. The configuration guide explains the supported options.

​
Before you start

For proxy requests, you need an active Residential/Mobile plan with available traffic and your Proxy Username and Proxy Password from the dashboard. For account API calls, you need an API key from Profile → API key. This is a separate credential. The language quickstarts show how to set credentials as environment variables. Keep real credentials out of committed code and shared logs.

​
Next steps

Start with the Python, Rust, or Go quickstart. Then use the shared guides for your next task:

​
Common questions

​
Do I need an SDK to use NodeMaven?

No. You can connect with any compatible proxy client. The SDKs help you build and validate settings in code.

​
Are the SDKs free?

Yes. All three are open source under the MIT license. Proxy usage is billed under your NodeMaven plan.

​
Do the SDKs retry failed requests?

No. Handle retries in your application or HTTP client. Check the failure first: retrying an invalid parameter or rejected credential will not fix it.

​
Can I use IP whitelisting with these examples?

These quickstarts use username/password authentication. The proxy builders require those credentials. For the separate credential-free workflow, see IP Whitelist setup.

​
Where can I report an SDK issue?

Open an issue in the relevant repository: Python, Rust, or Go. Include the package version and a minimal example with secrets removed.