# Proxio Documentation > Proxio is a proxy network for web scraping, SEO tracking, and large-scale data collection: pay-per-GB rotating residential proxies plus flat-rate, unlimited-bandwidth ISP and datacenter IPs. This is a categorized index of every documentation page, including the full REST API reference. Docs home: https://docs.proxio.net/docs Full text (every page in one file): https://docs.proxio.net/llms-full.txt OpenAPI 3.1 spec: https://dashboard.proxio.net/api/v1/openapi.json ## Overview - [Proxio Documentation](https://docs.proxio.net/docs): Proxio is a proxy network for web scraping, SEO tracking, and large-scale data collection, offering pay-per-GB rotating residential proxies plus flat-rate, unlimited-bandwidth ISP and datacenter IPs. Start here. ## Getting Started - [Introduction](https://docs.proxio.net/docs/getting-started): What Proxio is, how a proxy works, who these docs are for, and the three things you need before your first request. - [Quickstart: Your First Request](https://docs.proxio.net/docs/getting-started/quickstart): Sign up, buy a residential package, grab your credentials, and send a verified proxy request in cURL, Python, Node.js, or PHP, all in under two minutes. - [Dashboard Tour](https://docs.proxio.net/docs/getting-started/dashboard-tour): A guided walkthrough of dashboard.proxio.net, covering Home, Services, Orders, Wallet, Support tickets, and Settings. - [Choosing Your Setup](https://docs.proxio.net/docs/getting-started/choosing-your-setup): A decision guide for residential proxies that helps you pick a rotation type, a geo scope, and a protocol, or start from a built-in preset or the dashboard's Proxy Advisor. ## API Reference - [Proxio API](https://docs.proxio.net/docs/api): The Proxio REST API gives you one base URL, one auth scheme, one response envelope, cursor pagination, idempotent writes, signed webhooks, and an OpenAPI 3.1 document. Manage services, credentials, usage, orders, and proxy lists programmatically. - [Getting Started](https://docs.proxio.net/docs/api/getting-started): Create an API key in the Proxio dashboard, verify it with GET /account, and generate your first proxy list, with copy-paste examples in cURL, Python, and Node.js. - [Authentication](https://docs.proxio.net/docs/api/authentication): Authenticate to the Proxio API with a single Bearer key. Learn the pxo_ key format, the read / write / purchase scopes, per-key IP allowlists, expiry, and how to rotate keys safely. - [Errors](https://docs.proxio.net/docs/api/errors): The complete Proxio API error catalog. Every error returns a stable UPPER_SNAKE code, an HTTP status, a request_id, and a doc_url that deep-links to the matching section here. Includes retry guidance per code family. - [Rate Limits](https://docs.proxio.net/docs/api/rate-limits): Proxio API rate limits are documented and per-key. 120 requests per minute by default, a per-key override, and 60 per minute for unauthenticated discovery. Every response carries X-RateLimit-* headers, and 429s include Retry-After. - [Pagination](https://docs.proxio.net/docs/api/pagination): The Proxio API uses cursor pagination everywhere. Pass limit and cursor, read meta.next_cursor, and loop until it's null. Includes a copy-paste pagination loop in Python and Node.js. - [Idempotency](https://docs.proxio.net/docs/api/idempotency): Send an Idempotency-Key on Proxio API mutations so retries never double-charge or double-create. Learn the new / replay / conflict / in-progress semantics, which endpoints require the key, the 24-hour TTL, and the Idempotent-Replay header. - [Versioning & Stability](https://docs.proxio.net/docs/api/versioning): The Proxio API v1 stability policy. The v1 surface is additive-only, breaking changes require a new major version and 12 months notice via a Sunset date, an RFC 9745 Deprecation header, and a Link rel=deprecation, and every response carries X-Proxio-Api-Version. - [Account](https://docs.proxio.net/docs/api/account): Read your Proxio profile, wallet balance, and service totals in one call with GET /account. Includes cURL, Python, and Node.js examples. - [API Keys](https://docs.proxio.net/docs/api/api-keys): Manage Proxio API keys programmatically with GET/POST /api-keys and DELETE /api-keys/{id}. A key can only mint a key that is weaker than or equal to itself, the plaintext token is returned exactly once, and expiry, rate limit, and IP allowlist all clamp to the calling key's own values. - [Products](https://docs.proxio.net/docs/api/products): Read the Proxio catalog and live pricing with GET /products, including per-GB residential rates with volume tiers and per-IP-per-day ISP and datacenter pricing with duration discounts. ETag / If-None-Match give you a cheap 304 when pricing hasn't changed. - [Services](https://docs.proxio.net/docs/api/services): List your Proxio services and read connection info with GET /services and GET /services/{id}, and toggle auto-renewal with PATCH /services/{id}. A service is a package, residential services return a gateway endpoint and credential, static services return a fixed proxy list. - [Usage](https://docs.proxio.net/docs/api/usage): Read bandwidth usage for a Proxio service. GET /services/{id}/usage returns a summary (limit, used, remaining, today, success rate) and GET /services/{id}/usage/series returns a zero-filled time series with close-reason breakdowns. Explains the byte-quantity object. - [Credentials](https://docs.proxio.net/docs/api/credentials): Create and manage proxy sub-credentials on a Proxio residential service, list, create (with an optional KB/MB/GB traffic quota), update, delete, and rotate the password. Up to 20 per service. - [Proxy List](https://docs.proxio.net/docs/api/proxy-list): Generate ready-to-use Proxio proxy lines with GET /services/{id}/proxy-list. Targeting, including ASN, is embedded in the username, output as txt, json, or csv, with the full username grammar, every query parameter (count, sesstime, retry, retry_rotate, session_id, asn), sticky vs rotating, and practical recipes. - [Whitelist (IP Auth)](https://docs.proxio.net/docs/api/whitelist): Bind source IPs to a Proxio credential for passwordless authentication, with optional default geo and session settings. List, add, batch add, and remove bindings. Up to 50 per credential, 30 additions per minute. Covers INVALID_IP, IP_ALREADY_BOUND, and IP_UNAVAILABLE. - [Sessions](https://docs.proxio.net/docs/api/sessions): List and rotate a Proxio credential's active sticky sessions. GET returns every active session with remaining TTL, DELETE expires one or all. Rotation is rate-limited per credential. - [Locations](https://docs.proxio.net/docs/api/locations): Fetch Proxio's geo-targeting catalog with GET /locations, the country, state, and city codes you can target, in ISO 3166-1 alpha-2 / ISO 3166-2 / city-slug form. Cacheable for an hour, with ETag / If-None-Match support for a cheap 304 on an unchanged catalog. - [Wallet](https://docs.proxio.net/docs/api/wallet): Read your Proxio wallet balance with GET /wallet, fund it with POST /wallet/topups (a 201 is a payment link, not money), and page through the transaction ledger with GET /wallet/transactions, filterable by type and date range, sortable by created_at or amount. - [Orders](https://docs.proxio.net/docs/api/orders): List, quote, and place Proxio orders. GET /orders and /orders/{id} read your order history, POST /orders/quote prices one without buying it, POST /orders places a wallet-paid purchase, and POST /services/{id}/renew tops up or extends a service. Pricing is server-authoritative and both purchase writes require an idempotency key. - [Webhooks](https://docs.proxio.net/docs/api/webhooks): Receive events from Proxio instead of polling, as a signed JSON envelope or delivered to Discord or Slack. Full event catalog, payload shape, an X-Proxio-Signature verification walkthrough in Python and Node.js (t=,v1= scheme with 300s tolerance, JSON format only), retry and backoff, auto-disable, secret rotation, and a test endpoint. - [Deliveries](https://docs.proxio.net/docs/api/deliveries): The durable webhook delivery log and replay. GET /webhooks/{id}/deliveries and /deliveries/{deliveryId} hold 30 days of history per endpoint, POST .../redeliver replays one, and GET /events is the account-wide view across every endpoint, with type, delivered, and webhook_id filters. - [API Changelog](https://docs.proxio.net/docs/api/changelog): Additive-tagged changes to the Proxio API. Under the v1 stability policy, new fields, endpoints, events, and error codes ship continuously without breaking existing clients. Describes the current v1 surface. - [OpenAPI](https://docs.proxio.net/docs/api/openapi): The Proxio API ships an OpenAPI 3.1 document at https://dashboard.proxio.net/api/v1/openapi.json. Import it into Postman or Insomnia, or generate a typed client with openapi-generator. ## Proxies & Targeting - [Targeting & Username Syntax](https://docs.proxio.net/docs/proxies): The master reference for Proxio Residential proxies, covering how the user:pass@host:port connection string works and how to chain country, state, city, sticky-session and smart-retry parameters directly inside the username. - [Geo-Targeting: Country, State & City](https://docs.proxio.net/docs/proxies/geo-targeting): How to pin a Proxio Residential exit to a country, state or city using the -region-, -st- and -city- username segments, why state is a code and not a slugged name, and where to find the live location list. - [Session Types: Auto, Sticky & Smart](https://docs.proxio.net/docs/proxies/sessions): The three Proxio Residential rotation types explained, auto (fresh IP per request), sticky (hold one IP for 1 to 90 minutes) and smart (sticky plus connection retries), with the sessid/sesstime mechanics and exact retry rules. - [Rotation Presets](https://docs.proxio.net/docs/proxies/rotation-presets): Proxio ships six built-in rotation presets that bundle a rotation type, session length, retry policy, protocol and geo scope for common jobs, and you can save up to 50 private presets of your own. - [Protocols & Ports](https://docs.proxio.net/docs/proxies/protocols-and-ports): Proxio Residential serves HTTP/HTTPS and SOCKS5 on a single endpoint, geo.proxio.cc:16666. Learn when to use socks5h:// versus socks5://, why SOCKS5 is CONNECT-only, and how the gateway handles your TLS. - [IP Authentication (Passwordless)](https://docs.proxio.net/docs/proxies/ip-authentication): Whitelist the source IPs you control and connect to Proxio Residential with no username or password. Learn how per-binding geo and session defaults work, the 50-IP limit, the IP conflict rules, and the security tradeoff. - [ISP & Datacenter Proxies](https://docs.proxio.net/docs/proxies/isp-datacenter): Proxio ISP and Datacenter proxies are dedicated IPs delivered per order, each with its own host, port and credentials. They are built for flat-rate, unlimited-bandwidth workloads and do not use the Residential username-targeting grammar. ## Troubleshooting & FAQ - [Troubleshooting: Start Here](https://docs.proxio.net/docs/troubleshooting): A symptom index for Proxio. Find your problem, run the numbered checks, and jump straight to the fix for connection failures, 407s, wrong locations, slow speeds, blocks, and billing. - [Error & Response Code Reference](https://docs.proxio.net/docs/troubleshooting/error-codes): What every error means and how to fix it, covering Error 407 Proxy Authentication Required, 502/503/504 gateway failures, connection timeouts, plus target-site 403, 429 and CAPTCHA responses. - [Connection & Authentication Problems](https://docs.proxio.net/docs/troubleshooting/connection-auth): Fix Proxio connection failures and Error 407 by verifying the endpoint, copying credentials whole, URL-encoding passwords, picking the right scheme, and diagnosing IP authentication issues. - [Geo-Targeting Not Working](https://docs.proxio.net/docs/troubleshooting/geo-issues): Fix wrong-country, wrong-state, and wrong-city proxy results, covering city slugging (newyork, not new-york), why state is a code and not a slug, the country segment a state or city needs, geolocation-database disagreements and stale sticky sessions. - [Billing & Wallet FAQ](https://docs.proxio.net/docs/troubleshooting/billing-faq): Answers to Proxio billing questions, covering why a top-up hasn't credited, deposit bonus tiers, payment methods, how auto-renewal charges your wallet, pending orders, refunds and coupons. - [General FAQ](https://docs.proxio.net/docs/troubleshooting/faq): Quick answers about Proxio, covering supported protocols, bandwidth, credential and IP-binding limits, sticky session length, whether failed requests use quota, API availability, trials, logging and login methods. ## Dashboard & Account - [Dashboard & Account](https://docs.proxio.net/docs/dashboard): A guided tour of dashboard.proxio.net, showing where to manage your wallet, orders, credentials, and account settings. - [Wallet & Top-Up](https://docs.proxio.net/docs/dashboard/wallet): How Proxio's wallet works, covering topping up by card or crypto, bonus tiers, transaction history, and coupons. - [Orders: Buying, Renewing & Auto-Renewal](https://docs.proxio.net/docs/dashboard/orders): How Proxio orders work, covering the order lifecycle, placing and re-paying orders, auto-renewal, and renewal reminders. - [Usage Statistics](https://docs.proxio.net/docs/dashboard/usage-stats): What Proxio's Statistics tab shows, covering today's usage, the 7-day trend, remaining quota, and connection success rate. - [Credentials & Sub-Users](https://docs.proxio.net/docs/dashboard/credentials): Create up to 20 credentials per Residential package, each with its own login, quota cap, sessions, and blocked destinations. - [Blocked Destinations](https://docs.proxio.net/docs/dashboard/blocked-destinations): Stop a credential from reaching specific hosts or ports using blocklist presets and custom host/port rules, including what a blocked request looks like to your client. - [Telegram Bot](https://docs.proxio.net/docs/dashboard/telegram-bot): Link your Proxio account to Telegram, buy proxies, top up your wallet and check your services from a chat. ## Integrations - [Integrations](https://docs.proxio.net/docs/integrations): Connect Proxio to Python, Node.js, PHP, Java, C#, Go, browsers, antidetect tools, and scrapers. Every integration uses the same host, port, username, and password. - [Python](https://docs.proxio.net/docs/integrations/python): Route requests, httpx, and aiohttp through Proxio over HTTP or SOCKS5, hold a sticky session with the username grammar, and verify rotation with a script that prints the exit IP twice. - [Node.js](https://docs.proxio.net/docs/integrations/nodejs): Route native fetch, Axios, Got, and SOCKS5 clients through Proxio in Node.js, with install commands, complete scripts, and a verify step for each. - [Other Languages](https://docs.proxio.net/docs/integrations/other-languages): Route PHP, Java, C#, and Go through Proxio over HTTP or SOCKS5, the same four languages the dashboard's code generator covers, as complete minimal programs. - [Browsers & Proxy Managers](https://docs.proxio.net/docs/integrations/browsers): Route Windows, macOS, or Firefox through Proxio with built-in system proxy settings, or add Chrome with FoxyProxy or SwitchyOmega, with the exact fields to fill in for each. - [Antidetect Browsers](https://docs.proxio.net/docs/integrations/antidetect-browsers): Add Proxio to Multilogin, GoLogin, AdsPower, Dolphin Anty, or Octo Browser, where every profile's proxy form takes the same five fields, checked with the tool's own connection test. - [Scrapers & Automation](https://docs.proxio.net/docs/integrations/scrapers): Wire Proxio into Scrapy, Selenium, Puppeteer, and Playwright with minimal complete examples, each with proxy authentication and a verify step. ## Resources - [Resources](https://docs.proxio.net/docs/resources): Policies, the affiliate program, and support channels for Proxio. - [Acceptable Use](https://docs.proxio.net/docs/resources/acceptable-use): What Proxio's proxy network is built for, what's prohibited, and how destination blocklists help keep the network clean. - [Affiliate Program](https://docs.proxio.net/docs/resources/affiliate): Earn commission for referring customers to Proxio, including the commission range and how to join by email. - [Contact Support](https://docs.proxio.net/docs/resources/support): How to reach Proxio support by opening a dashboard ticket, picking the right category and priority, and including the details needed for the fastest resolution.