Documentation

Everything needed to connect, rotate and automate Proxuno proxies — 22 guides, from the first request to the full REST API reference, kept in step with each release.

API v1 · public reference Platform v5.5.1, released 3 Oct 2026 Changelog

Search the documentation

Matches guide titles and section headings. Press / to focus.

Browse by topic

Guides are grouped by product and task. Each page shows the date of its last revision; examples are tested against the current release.

Getting started

4 guides

First connection, authentication modes, IP whitelisting and the line formats used by every export.

Mobile proxies

2 guides

Dedicated 4G/5G modems: hosts and ports, carriers, protocols and IP rotation on demand or on a schedule.

Residential

2 guides

Pay-per-GB rotating pool with country and city targeting and sticky sessions of up to 30 minutes.

Static ISP

1 guide

Dedicated static IPs announced by residential ISPs, unlimited bandwidth, billed per IP every 30 days.

Static ISP proxies

REST API

4 guides

List and configure proxies, rotate IPs, read usage and generate residential endpoints from your own code.

Integrations

8 guides

Tested setups for HTTP clients, headless browsers, Scrapy, antidetect browsers, phones and browser extensions.

Best practices

1 guide

Concurrency, retries, rate limits and what the acceptable use policy expects from your traffic.

Limits & best practices

Most-read guides

Where most customers start after their first order.

Getting started Quick start From a new account to a first request through a dedicated mobile, rotating residential or static ISP proxy in under five minutes. Read more Mobile proxies IP rotation Change the IP of a mobile proxy from the dashboard, a rotation link, the REST API or on an automatic schedule from 2 to 60 minutes — with the 10-second cooldown explained. Read more Residential Residential targeting Choose the country and city of rotating residential IPs with username flags, the list of country codes, and how traffic is counted. Read more REST API Proxies, usage & orders API Reference for GET /proxies, GET /proxies/{id}, POST /proxies/{id}/rotate, PATCH /proxies/{id}, GET /usage and GET /orders — parameters, responses and examples. Read more Integrations Puppeteer & Playwright Run headless Chromium, Firefox and WebKit through authenticated mobile, residential and static ISP proxies with Puppeteer and Playwright, per browser or per context. Read more Integrations Antidetect browsers Field-by-field proxy setup for Multilogin, GoLogin, AdsPower, Dolphin Anty and similar profile browsers, with rotation links and per-profile sticky residential sessions. Read more

REST API

Rotate a mobile IP with one request

Every action available in the dashboard is also available over HTTPS: authenticate with an API key, call the endpoint, read JSON. Keys are limited to 60 requests per minute and a mobile proxy can be rotated once every 10 seconds.

Base URL https://proxuno.com/api/v1

Header Authorization: Bearer pxl_live_…

Versioned under /api/v1: changes within a major version are additive, with no removals or renames.
60 requests per minute per key, with X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset on every response.
One error shape everywhere — a machine-readable code and a human-readable message.

API reference Create an API key

curl -X POST https://proxuno.com/api/v1/proxies/1482/rotate \
  -H "Authorization: Bearer $PROXUNO_API_KEY"

import os, requests

r = requests.post(
    "https://proxuno.com/api/v1/proxies/1482/rotate",
    headers={"Authorization": f"Bearer {os.environ['PROXUNO_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://proxuno.com/api/v1/proxies/1482/rotate", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PROXUNO_API_KEY}` },
});
console.log(res.status, await res.json());

<?php
$ch = curl_init("https://proxuno.com/api/v1/proxies/1482/rotate");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("PROXUNO_API_KEY")],
]);
echo curl_exec($ch);

Replace 1482 with the id returned by GET /proxies. Store the key in an environment variable, never in source control.

Still stuck?

Short answers, live network state, and engineers who read your logs.

FAQ Billing, refunds, rotation limits, crypto payments and account security in short answers. Network status Live state of every gateway, 90-day uptime and the full incident history. Contact support Support every day, 08:00–22:00 CET. Network monitoring 24/7. Open a ticket from the dashboard or write to @proxuno_support on Telegram.