Документация API и подключения

Подключение к прокси

Каждый порт получает индивидуальные логин и пароль. Один и тот же порт работает по двум протоколам — перевыпуск не нужен, просто выберите нужный порт:

• HTTP / HTTPS — порт ports.http из ответа API;
• SOCKS5 — порт ports.socks5.

Авторизация — по логину и паролю или по белому списку IP (привязка к вашему статическому адресу настраивается через поддержку).

Форматы строки подключения

# host:port:login:password — для антидетектов и большинства софта
203.0.113.10:8040:WUIRzA91:F9RQcuRw

# login:password@host:port — для библиотек и cURL
http://WUIRzA91:F9RQcuRw@203.0.113.10:8040
socks5://WUIRzA91:F9RQcuRw@203.0.113.10:5040

Проверка за 10 секунд

curl -x http://LOGIN:PASSWORD@HOST:HTTP_PORT https://api.ipify.org

Команда вернёт внешний IP прокси. Проверить геолокацию, скорость и анонимность можно в нашем чекере прокси.

Аутентификация API

Базовый адрес API — https://app.arendaproxy.ru. Ключ доступа выдаётся в личном кабинете, раздел «API». Передайте его одним из двух способов:

Заголовок предпочтительнее: ключ из URL может осесть в логах прокси-серверов и истории браузера. Если ключ скомпрометирован — напишите в поддержку, мы перевыпустим его.

GET/api/v1/proxy

Основной метод. Одним запросом возвращает все ваши прокси с реквизитами, ссылками на смену IP и информацией о биллинге.

curl -H "X-API-Key: YOUR_API_KEY" https://app.arendaproxy.ru/api/v1/proxy

import requests

r = requests.get("https://app.arendaproxy.ru/api/v1/proxy",
                 headers={"X-API-Key": "YOUR_API_KEY"}, timeout=15)
data = r.json()

for p in data["proxies"]:
    print(f"{p['host']}:{p['ports']['http']}:{p['username']}:{p['password']}")

const res = await fetch("https://app.arendaproxy.ru/api/v1/proxy", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();

data.proxies.forEach(p => {
  console.log(`${p.host}:${p.ports.http}:${p.username}:${p.password}`);
});

<?php
$ch = curl_init("https://app.arendaproxy.ru/api/v1/proxy");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ["X-API-Key: YOUR_API_KEY"],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 15,
]);
$data = json_decode(curl_exec($ch), true);

foreach ($data["proxies"] as $p) {
    echo "{$p['host']}:{$p['ports']['http']}:{$p['username']}:{$p['password']}\n";
}

req, _ := http.NewRequest("GET", "https://app.arendaproxy.ru/api/v1/proxy", nil)
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := (&http.Client{Timeout: 15 * time.Second}).Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

var data struct {
    Proxies []struct {
        ID          string `json:"id"`
        Host        string `json:"host"`
        Ports       struct{ HTTP, SOCKS5 int } `json:"ports"`
        Username    string `json:"username"`
        Password    string `json:"password"`
        ChangeIPURL string `json:"change_ip_url"`
    } `json:"proxies"`
}
json.NewDecoder(resp.Body).Decode(&data)
for _, p := range data.Proxies {
    fmt.Printf("%s:%d:%s:%s\n", p.Host, p.Ports.HTTP, p.Username, p.Password)
}

Ответ

{
  "success": true,
  "client": "ClientName",
  "billing": {
    "type": "per_gb",
    "price_per_gb": 55,
    "currency": "RUB",
    "balance": 12000,
    "usage_mb": 2686976
  },
  "proxies": [
    {
      "id": "MD2_64",
      "host": "203.0.113.10",
      "ports": { "http": 8040, "socks5": 5040 },
      "username": "WUIRzA91",
      "password": "F9RQcuRw",
      "country": "MD",
      "country_name": "Moldova",
      "operator": "Orange",
      "online": true,
      "change_ip_url": "http://203.0.113.10:7002/apix/reset_ip_secure?hash=..."
    }
  ],
  "proxy_count": 10
}

Поля ответа

GET/api/v1/proxies

Короткий список прокси без биллинга — удобно для автоматической подстановки в софт. Формат задаётся параметром format:

curl -H "X-API-Key: YOUR_API_KEY" "https://app.arendaproxy.ru/api/v1/proxies?format=txt" > proxies.txt

GETchange_ip_url

У каждого мобильного прокси в ответе /api/v1/proxy есть поле change_ip_url — прямая ссылка на сервер модемов. Выполните по ней GET-запрос, и модем получит новый IP. Запрос идёт напрямую на модемный узел, без промежуточного сервера.

1. Вызовите GET /api/v1/proxy и получите список прокси.
2. Возьмите change_ip_url нужного модема.
3. Выполните GET-запрос на этот URL — новый IP будет выдан через 10–15 секунд.

# change_ip_url берётся из ответа /api/v1/proxy
curl -s "$CHANGE_IP_URL" && sleep 15
curl -x http://LOGIN:PASSWORD@HOST:HTTP_PORT https://api.ipify.org  # новый IP

import time, requests

data = requests.get("https://app.arendaproxy.ru/api/v1/proxy",
                    headers={"X-API-Key": "YOUR_API_KEY"}, timeout=15).json()

p = next(x for x in data["proxies"] if x["id"] == "MD2_64")
requests.get(p["change_ip_url"], timeout=30)
time.sleep(15)  # дождаться нового IP

const data = await (await fetch("https://app.arendaproxy.ru/api/v1/proxy", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
})).json();

const p = data.proxies.find(x => x.id === "MD2_64");
await fetch(p.change_ip_url);
await new Promise(r => setTimeout(r, 15000));  // дождаться нового IP

<?php
$ch = curl_init($p["change_ip_url"]);   // $p — прокси из ответа /api/v1/proxy
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30]);
curl_exec($ch);
sleep(15);  // дождаться нового IP

resp, err := (&http.Client{Timeout: 30 * time.Second}).Get(p.ChangeIPURL)
if err == nil { resp.Body.Close() }
time.Sleep(15 * time.Second) // дождаться нового IP

Не вызывайте смену IP на одном модеме чаще одного раза в 30 секунд — слишком частые запросы может ограничить оператор. Ссылку можно сохранить и вызывать из любого софта (антидетект, ZennoPoster, BAS, cron).

Помимо API, доступна автоматическая ротация по таймеру — от 2 минут; настраивается по запросу в поддержку.

Примеры интеграции

Python — запрос через прокси и смена IP

import requests

API_KEY = "YOUR_API_KEY"
data = requests.get("https://app.arendaproxy.ru/api/v1/proxy",
                    headers={"X-API-Key": API_KEY}, timeout=15).json()

if not data["success"]:
    raise SystemExit(data.get("error"))

p = data["proxies"][0]
proxy = f"http://{p['username']}:{p['password']}@{p['host']}:{p['ports']['http']}"

r = requests.get("https://api.ipify.org?format=json",
                 proxies={"http": proxy, "https": proxy}, timeout=15)
print("IP:", r.json()["ip"])

requests.get(p["change_ip_url"], timeout=30)  # сменить IP

Node.js — все прокси в формате host:port:login:pass

const res = await fetch("https://app.arendaproxy.ru/api/v1/proxy", {
  headers: { "X-API-Key": process.env.ARENDAPROXY_KEY }
});
const data = await res.json();

for (const p of data.proxies) {
  console.log(`HTTP   ${p.host}:${p.ports.http}:${p.username}:${p.password}`);
  console.log(`SOCKS5 ${p.host}:${p.ports.socks5}:${p.username}:${p.password}`);
}

Bash — выгрузка в файл

curl -s -H "X-API-Key: YOUR_API_KEY" https://app.arendaproxy.ru/api/v1/proxy \
  | python3 -c "import sys,json
for p in json.load(sys.stdin)['proxies']:
    print(f\"{p['host']}:{p['ports']['http']}:{p['username']}:{p['password']}\")" \
  > proxies.txt

Больше сценариев — в статьях «Прокси в Python: requests, Scrapy, Selenium» и «Настройка прокси в антидетект-браузере».

Коды ошибок

При ошибке API возвращает JSON с success: false и описанием в поле error:

{"success": false, "error": "Invalid API key"}

Лимиты и параметры

Публичные данные

Без ключа доступны данные мониторинга, которые мы публикуем на сайте:

Нужен ключ или тестовый доступ? Начните с платного теста на 24 часа или напишите в Telegram — ответим в течение 15 минут.