Documentation

Getting Started

Welcome to iProyals! This guide will help you get up and running with our proxy services in minutes. Follow the steps below to make your first proxy request.

1. Create Your Account

Sign up for an iProyals account at myaccount.iproyals.shop and choose the proxy type that best fits your needs. No credit card required to start.

2. Get Your Credentials

Navigate to your dashboard to find your authentication credentials — your username, password, and API key. These are unique to your account and used to authenticate every request.

3. Configure Your Connection

Use the connection details provided in your dashboard to configure your application. See the connection methods and code examples below for your specific use case.

Connection Methods

HTTP/HTTPS Proxies

Standard proxy format for web browsers, HTTP clients, and most automation tools:

Host: proxy.iproyals.shop
Port: 8080
Username: your_username
Password: your_password

Format: http://username:password@proxy.iproyals.shop:8080

SOCKS5 Proxies

For applications requiring SOCKS5 protocol support with UDP and all traffic types:

Host: socks.iproyals.shop
Port: 1080
Username: your_username
Password: your_password

Format: socks5://username:password@socks.iproyals.shop:1080

Rotating Residential Proxies

For automatic IP rotation on every request or session. Connect to our gateway and we handle the rest:

Host: rotate.iproyals.shop
Port: 8888
Username: your_username
Password: your_password

Sticky session: username-session-SESSIONID:password

API Reference

Authentication

All API requests require authentication using your API key, which you can find in your dashboard:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Get Account Info

GET https://api.iproyals.shop/v1/account

Response:
{
  "username": "your_username",
  "balance": 100.00,
  "proxy_count": 10,
  "bandwidth_used": "50GB",
  "plan": "residential"
}

List Active Proxies

GET https://api.iproyals.shop/v1/proxies

Response:
{
  "proxies": [
    {
      "id": "proxy_123",
      "type": "residential",
      "ip": "103.45.67.89",
      "port": 8080,
      "country": "US",
      "status": "active"
    }
  ]
}

Get Usage Statistics

GET https://api.iproyals.shop/v1/usage

Response:
{
  "bandwidth_used_gb": 5.2,
  "requests_total": 48320,
  "success_rate": 99.1,
  "period": "current_month"
}

Code Examples

Python (requests)

import requests

proxies = {
    'http': 'http://username:password@proxy.iproyals.shop:8080',
    'https': 'http://username:password@proxy.iproyals.shop:8080'
}

response = requests.get('https://api.ipify.org', proxies=proxies)
print(f'Your IP: {response.text}')

Node.js (axios)

const axios = require('axios');

const proxy = {
  host: 'proxy.iproyals.shop',
  port: 8080,
  auth: {
    username: 'your_username',
    password: 'your_password'
  }
};

axios.get('https://api.ipify.org', { proxy })
  .then(response => console.log('Your IP:', response.data));

cURL

curl -x proxy.iproyals.shop:8080 \
     -U username:password \
     https://api.ipify.org

PHP (cURL)

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.ipify.org');
curl_setopt($ch, CURLOPT_PROXY, 'proxy.iproyals.shop:8080');
curl_setopt($ch, CURLOPT_PROXYUSERPWD, 'username:password');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo 'Your IP: ' . $response;