Mobile Proxy Code Examples: cURL, Python, Node.js, Go

Each example sends one request through an ipvolt mobile proxy and prints the outgoing IP. They read the connection details from environment variables, so no credentials end up in your code:

export PROXY_URL="http://USERNAME:PASSWORD@HOST:HTTP_PORT"
export PROXY_HOST="HOST"
export PROXY_HTTP_PORT="HTTP_PORT"
export PROXY_USERNAME="USERNAME"
export PROXY_PASSWORD="PASSWORD"

The printed IP should match the outgoing IP in your dashboard. Each section links to a guide that covers the client's options and errors in depth.

cURL

curl -sS -x "$PROXY_URL" https://api.ipify.org

For SOCKS5, use -x "socks5h://USERNAME:PASSWORD@HOST:SOCKS5_PORT". See Use a proxy with curl.

Python Requests

python

import os
import requests

proxy = os.environ["PROXY_URL"]
response = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=30)
print(response.text)

For a socks5h:// URL, install requests[socks] first. See Python Requests proxy.

Python HTTPX

python

import os
import httpx

with httpx.Client(proxy=os.environ["PROXY_URL"], timeout=30) as client:
    print(client.get("https://api.ipify.org").text)

See HTTPX async proxies.

Python aiohttp

python

import asyncio
import os
import aiohttp


async def main():
    async with aiohttp.ClientSession() as session:
        async with session.get("https://api.ipify.org", proxy=os.environ["PROXY_URL"]) as response:
            print(await response.text())


asyncio.run(main())

See aiohttp proxies.

Node.js

import { fetch, ProxyAgent } from 'undici';

const dispatcher = new ProxyAgent(process.env.PROXY_URL);
const response = await fetch('https://api.ipify.org', { dispatcher });
console.log(await response.text());

On Node.js 24.5 or later, the built-in fetch can use the proxy without undici: run your script with NODE_USE_ENV_PROXY=1 and HTTPS_PROXY set to the proxy URL. See Use a proxy with Node.js fetch.

Playwright

import { chromium } from 'playwright';

const browser = await chromium.launch({
  proxy: {
    server: `http://${process.env.PROXY_HOST}:${process.env.PROXY_HTTP_PORT}`,
    username: process.env.PROXY_USERNAME,
    password: process.env.PROXY_PASSWORD,
  },
});
const page = await browser.newPage();
await page.goto('https://api.ipify.org');
console.log(await page.textContent('body'));
await browser.close();

Use the HTTP port for browsers: Chromium does not send SOCKS5 credentials. See Configure a proxy in Playwright.

Puppeteer

import puppeteer from 'puppeteer';

const browser = await puppeteer.launch({
  args: [`--proxy-server=http://${process.env.PROXY_HOST}:${process.env.PROXY_HTTP_PORT}`],
});
const page = await browser.newPage();
await page.authenticate({ username: process.env.PROXY_USERNAME, password: process.env.PROXY_PASSWORD });
await page.goto('https://api.ipify.org');
console.log(await page.evaluate(() => document.body.innerText));
await browser.close();

See Fix ERR_TUNNEL_CONNECTION_FAILED if the page does not load.

Scrapy

python

import os
import scrapy


class IpSpider(scrapy.Spider):
    name = "ip"

    async def start(self):
        yield scrapy.Request("https://api.ipify.org", meta={"proxy": os.environ["PROXY_URL"]})

    def parse(self, response):
        self.logger.info("Outgoing IP: %s", response.text)

See Scrapy proxies.

Go

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
	"os"
	"time"
)

func main() {
	proxyURL, err := url.Parse(os.Getenv("PROXY_URL"))
	if err != nil {
		panic(err)
	}
	client := &http.Client{
		Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
		Timeout:   30 * time.Second,
	}
	resp, err := client.Get("https://api.ipify.org")
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	body, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

Code examples

cURL

Python Requests

Python HTTPX

Python aiohttp

Node.js

Playwright

Puppeteer

Scrapy

Go

Plug in your first proxy.