Skip to main content
Install the Go SDK and send your first proxy request with the standard library. The nodemaven-go module builds proxy settings for Go’s net/http client and other clients that accept a proxy URL. It also provides separate browser proxy fields and an account API client.

Before you start

You need Go 1.22 or newer, an active Residential/Mobile plan with available traffic, and your proxy credentials. This quickstart uses SDK version v0.1.1.

1. Create a module

In a new project directory, run:
If you are adding the SDK to an existing Go module, run only the go get command.

2. Set your proxy credentials

Open the NodeMaven dashboard, go to Rotating Residential Proxy → Authenticated, and find your credentials under Proxy generator. Proxy Setup 2 Use your base proxy username, without generated targeting or session suffixes. The SDK builds those from your options. These credentials are different from your dashboard sign-in email and password. On macOS or Linux:
On Windows PowerShell:
Run the program from this terminal. The SDK reads environment variables but does not load .env files automatically.

3. Send your first request

Create main.go:
Run it:
The output contains the proxy’s public exit IP. For example:
This is illustrative output. Your IP will be different, and the request uses proxy traffic. The SDK reads your credentials from the environment. nodemaven.WithParam("filter", "medium") corresponds to the dashboard’s Quality mode. nodemaven.New builds a configuration locally; the HTTP client makes the request.

Choose the right output

For a browser driver, map proxy.Browser() fields to that driver’s own proxy and authentication options. The SDK does not start the browser. Although printing a Proxy masks its password, URL() and the fields returned for clients contain real credentials; keep them out of shared logs.

Reuse the client

Create a client and transport once for each proxy identity you intend to reuse. Reusing them preserves connection pooling. When you create a different SDK proxy object, configure a transport for that object as well: changing your Go variable does not update an existing HTTP client’s proxy settings.

Next steps

Full method reference: pkg.go.dev. Source and issues: nodemaven-go.