API v1

API Proxly. Прокси из вашего кода.

Base URL
https://proxly.org/api/v1

Обзор.

API даёт то же, что личный кабинет: баланс, ваши прокси с логином и паролем, готовые строки подключения с выбором страны, города и ASN, расход трафика, заказы и покупку гигабайт Residential и Datacenter с баланса.

  • Запросы и ответы — JSON в UTF-8.
  • Время — ISO 8601 в UTC, объём — в гигабайтах.
  • Деньги — в рублях; доллары — по курсу сайта 90 ₽ = $1.

Быстрый старт.

  1. Подтвердите почту и откройте Кабинет → API.
  2. Нажмите «Создать ключ», выберите права — «Только чтение» или «Чтение и покупки» — и сохраните ключ: он показывается один раз.
  3. Проверьте ключ запросом к /account, затем получите строки подключения своего доступа.
curl "https://proxly.org/api/v1/account" \
  -H "Authorization: Bearer pxl_your_key"

curl "https://proxly.org/api/v1/proxies" \
  -H "Authorization: Bearer pxl_your_key"

Авторизация.

Каждый запрос несёт ключ в заголовке Authorization: Bearer pxl_…. Вход в кабинет и его cookies API не принимает.

  • «Только чтение» — все запросы GET. «Чтение и покупки» — ещё покупка трафика и смена пароля доступа.
  • До 5 действующих ключей на аккаунт. Отозванный ключ перестаёт работать сразу.
  • Смена или сброс пароля и смена почты отзывают все ключи аккаунта — после этого создайте новые. «Выйти на других устройствах» ключи не трогает: подозрительный ключ отзовите в разделе «API».
  • О каждом новом ключе приходит уведомление в кабинете. Не создавали — отзовите ключ.
  • Не вставляйте ключ в код страниц сайта, адреса и открытые репозитории — он даёт доступ к паролям прокси и балансу.

Ответы и ошибки.

Успешный ответ — { "ok": true, "data": … }, ошибка — { "ok": false, "error": { "code", "message" } } с HTTP-статусом. Проверяйте code: message — пояснение на английском.

401
{
  "ok": false,
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key. Send it as `Authorization: Bearer <key>`."
  }
}
HTTPcodeЧто случилось
400bad_requestНеверный параметр или тело запроса — в message сказано, какой.
400idempotency_key_requiredПокупке нужен заголовок Idempotency-Key.
400bad_paramsТакой объём нельзя купить: смотрите min_gb, max_gb и packages в GET /products.
401unauthorizedНет ключа, ключ неверный или отозван.
402insufficient_fundsНа балансе не хватает денег. Пополните его в кабинете.
403read_only_keyКлюч «Только чтение» не может покупать и менять пароли.
403email_not_verifiedПодтвердите почту аккаунта в кабинете.
403account_unavailableАккаунт недоступен — напишите в @proxly_sup.
404not_foundНет такого метода, доступа или заказа в вашем аккаунте.
405—Путь есть, но не с этим HTTP-методом (например, POST /account) — ответ без тела.
409order_rejectedЗаказ не оформлен по другой причине — повторите или напишите в @proxly_sup.
409unavailableТакой объём сейчас нельзя купить — попробуйте меньше или позже.
409idempotency_conflictЭтот Idempotency-Key уже использован для другого заказа.
409promo_unavailableПромокод не подходит к заказу.
409not_supportedЭтому доступу действие недоступно — например, у заказа нет своего пароля.
409expiredСрок статического прокси истёк — продлите его в кабинете.
409not_readyАдреса ещё выдаются — повторите через несколько минут.
429rate_limitedСлишком много запросов. Повторите через Retry-After секунд.
500server_errorОшибка на нашей стороне. Повторите позже.
502temporarily_unavailableПароль не сменился, старый работает. Повторите через несколько минут.
503sales_unavailableПокупки временно недоступны.
503catalog_unavailableЦены сейчас не загрузились — повторите через минуту.
503locations_unavailableСписок городов и ASN сейчас недоступен — повторите через минуту.
503password_change_unavailableСмена пароля ISP и IPv4 временно недоступна.

Лимиты.

  • 120 запросов в минуту на ключ.
  • 20 покупок за 5 минут на аккаунт — вместе с покупками в кабинете.
  • Смена пароля ротационного доступа — до 5 раз в час.
  • 60 неверных ключей в минуту с одного адреса — дальше минуту этот адрес получает 429 на любой ключ, и верный тоже.
  • Сверх лимита — ответ 429 rate_limited с заголовком Retry-After в секундах.

Аккаунт.

Аккаунт и баланс

GET/api/v1/account

Почта, подтверждена ли она, баланс в рублях и в долларах по курсу сайта 90 ₽ = $1 и права ключа. Удобно для проверки ключа.

Любой ключ

Поля ответа

idstring
Номер аккаунта.
email, email_verifiedstring, boolean
Почта аккаунта и подтверждена ли она. Покупки — только с подтверждённой почтой.
balance_rub, balance_usdnumber
Баланс. Хранится в рублях, доллары — по курсу 90.
key_scopestring
read — только чтение, write — чтение и покупки.
curl "https://proxly.org/api/v1/account" \
  -H "Authorization: Bearer pxl_your_key"
Ответ
{
  "ok": true,
  "data": {
    "id": "8b8c2639-23d7-49b9-bc23-b368fcd04445",
    "email": "you@example.com",
    "email_verified": true,
    "balance_rub": 2000,
    "balance_usd": 22.22,
    "key_scope": "write"
  }
}

Каталог.

Тарифы

GET/api/v1/products

Что можно купить через API и по какой цене — те же цены, что в таблице тарифов сайта, со скидкой за объём. Через API покупаются Residential и Datacenter; ISP и IPv4 оформляются в кабинете.

Любой ключ

Поля ответа

typestring
residential или datacenter.
availableboolean
Продаётся ли сейчас.
min_gb, max_gbnumber
Сколько ГБ можно купить за один заказ.
packagesnumber[] | null
null — любой целый объём от min_gb до max_gb; иначе только эти объёмы.
pricesobject[]
Цены популярных объёмов: gb, price_rub, price_usd и цена за ГБ. Итог заказа вернёт POST /orders.

В примере ответ сокращён: в prices приходят объёмы 1, 5, 10, 25, 50, 100, 500 и 1000 ГБ.

Запрос
curl "https://proxly.org/api/v1/products" \
  -H "Authorization: Bearer pxl_your_key"
Ответ
{
  "ok": true,
  "data": [
    {
      "type": "residential",
      "available": true,
      "unit": "gb",
      "min_gb": 1,
      "max_gb": 2000,
      "packages": null,
      "protocols": [
        "http",
        "socks5"
      ],
      "prices": [
        {
          "gb": 1,
          "price_rub": 108,
          "price_usd": 1.2,
          "per_gb_rub": 108,
          "per_gb_usd": 1.2
        },
        {
          "gb": 10,
          "price_rub": 900,
          "price_usd": 10,
          "per_gb_rub": 90,
          "per_gb_usd": 1
        },
        {
          "gb": 100,
          "price_rub": 7200,
          "price_usd": 80,
          "per_gb_rub": 72,
          "per_gb_usd": 0.8
        }
      ]
    },
    {
      "type": "datacenter",
      "available": true,
      "unit": "gb",
      "min_gb": 1,
      "max_gb": 2000,
      "packages": null,
      "protocols": [
        "http",
        "socks5"
      ],
      "prices": [
        {
          "gb": 1,
          "price_rub": 90,
          "price_usd": 1,
          "per_gb_rub": 90,
          "per_gb_usd": 1
        },
        {
          "gb": 10,
          "price_rub": 720,
          "price_usd": 8,
          "per_gb_rub": 72,
          "per_gb_usd": 0.8
        },
        {
          "gb": 100,
          "price_rub": 5400,
          "price_usd": 60,
          "per_gb_rub": 54,
          "per_gb_usd": 0.6
        }
      ]
    }
  ]
}

Страны, города и ASN

GET/api/v1/locations

Список стран вида прокси. С параметром country — города, штаты и ASN этой страны: их коды подставляются в строку подключения.

Любой ключ

Параметры запроса

typestring
residential (по умолчанию) или datacenter.
countrystring
Код страны из двух букв, например US.

Это ответ с country. Без country в data — список стран: [{ "code": "US", "name": "United States" }, …].

curl "https://proxly.org/api/v1/locations?type=datacenter&country=US" \
  -H "Authorization: Bearer pxl_your_key"
Ответ
{
  "ok": true,
  "data": {
    "code": "US",
    "name": "United States",
    "cities": [
      {
        "code": "new_york",
        "name": "New York"
      }
    ],
    "states": [
      {
        "code": "california",
        "name": "California"
      }
    ],
    "asns": [
      {
        "code": "7922",
        "name": "Comcast"
      }
    ]
  }
}

Доступы.

Все доступы

GET/api/v1/proxies

Все доступы аккаунта — как в кабинете: ротационные (один доступ на вид, купленный объём суммируется), подарочные и статические ISP и IPv4. С логином, паролем, портами и остатком трафика.

Любой ключ

Поля ответа

idstring
Номер доступа. Подарок новому аккаунту — gift:residential или gift:datacenter.
typestring
residential, datacenter, isp или ipv4.
trialboolean
true у подарочного доступа.
statusstring
Состояние доступа: active — работает.
host, portsstring, object
Адрес и порты: http, socks5 (у ротационных один порт для обоих) и https. null — протокол недоступен.
username, passwordstring
Логин и пароль доступа. Храните их как пароль.
trafficobject | null
limit_gb, used_gb, remaining_gb у ротационных; null у статических — у них трафик без лимита.
countrystring | null
Страна статического адреса. У ротационных страна задаётся в строке подключения.
order_id, expires_at, created_atstring | null
Заказ, срок действия и время создания (ISO 8601, UTC).
curl "https://proxly.org/api/v1/proxies" \
  -H "Authorization: Bearer pxl_your_key"
Ответ
{
  "ok": true,
  "data": [
    {
      "id": "3f1c9a52-7b0e-4d2a-9c61-2f8e4b7d0a13",
      "type": "residential",
      "trial": false,
      "status": "active",
      "host": "78.153.130.98",
      "ports": {
        "http": 8080,
        "socks5": 8080,
        "https": 8443
      },
      "username": "r6bad7d204c",
      "password": "Xk29fLq7",
      "traffic": {
        "limit_gb": 10,
        "used_gb": 2.418,
        "remaining_gb": 7.582
      },
      "country": null,
      "order_id": "c2a9e0d4-51f3-4b8e-a7d6-0e3b9f12c845",
      "expires_at": null,
      "created_at": "2026-10-20T09:14:03.000Z"
    }
  ]
}

Один доступ

GET/api/v1/proxies/{id}

Тот же объект, что в списке, по номеру доступа.

Любой ключ

Параметры пути

idstringобязательно
Номер доступа из GET /proxies или gift:residential / gift:datacenter.
Запрос
curl "https://proxly.org/api/v1/proxies/3f1c9a52-7b0e-4d2a-9c61-2f8e4b7d0a13" \
  -H "Authorization: Bearer pxl_your_key"
Ответ
{
  "ok": true,
  "data": {
    "id": "3f1c9a52-7b0e-4d2a-9c61-2f8e4b7d0a13",
    "type": "residential",
    "trial": false,
    "status": "active",
    "host": "78.153.130.98",
    "ports": {
      "http": 8080,
      "socks5": 8080,
      "https": 8443
    },
    "username": "r6bad7d204c",
    "password": "Xk29fLq7",
    "traffic": {
      "limit_gb": 10,
      "used_gb": 2.418,
      "remaining_gb": 7.582
    },
    "country": null,
    "order_id": "c2a9e0d4-51f3-4b8e-a7d6-0e3b9f12c845",
    "expires_at": null,
    "created_at": "2026-10-20T09:14:03.000Z"
  }
}

Строки подключения

GET/api/v1/proxies/{id}/endpoints

Готовые строки для программ и скриптов — как генератор в кабинете: страна, город, ASN, sticky-сессии с временем удержания IP. Выбор страны и сессии — у ротационных доступов; статическому вернётся его адрес. Параметр, который доступу недоступен, даёт ошибку 400, а не строку без него.

Любой ключ

Параметры пути

idstringобязательно
Номер доступа.

Параметры запроса

protocolstring
http (по умолчанию), https или socks5.
formatstring
host:port:user:pass (по умолчанию), user:pass@host:port или url.
countrystring
Код страны из GET /locations. Без него — любая страна.
citystring
Код города из GET /locations (нужна country).
statestring
Код штата или региона, только Datacenter (нужна country). Вместе с city не передаётся: город уже задаёт регион.
asnstring
Номер ASN провайдера из GET /locations (нужна country).
osstring
windows, android, ios или mac — только Datacenter.
strictboolean
Только Datacenter: true (по умолчанию) — только точное совпадение города, штата или ASN; false — близкий адрес, если точного нет.
sessionstring
rotating (по умолчанию) — новый IP на каждое соединение; sticky — IP держится в пределах сессии.
countnumber
Сколько sticky-сессий выдать, 1–1000; только с session=sticky.
lifetimenumber
Сколько минут держать IP; только с session=sticky. Residential — 1–30, Datacenter — 5–1440.
curl "https://proxly.org/api/v1/proxies/3f1c9a52-7b0e-4d2a-9c61-2f8e4b7d0a13/endpoints?country=US&session=sticky&count=3&lifetime=30" \
  -H "Authorization: Bearer pxl_your_key"
Ответ
{
  "ok": true,
  "data": {
    "proxy_id": "3f1c9a52-7b0e-4d2a-9c61-2f8e4b7d0a13",
    "protocol": "http",
    "format": "host:port:user:pass",
    "session": "sticky",
    "endpoints": [
      "78.153.130.98:8080:r6bad7d204c-country-us-session-1-time-30:Xk29fLq7",
      "78.153.130.98:8080:r6bad7d204c-country-us-session-2-time-30:Xk29fLq7",
      "78.153.130.98:8080:r6bad7d204c-country-us-session-3-time-30:Xk29fLq7"
    ]
  }
}

Расход трафика

GET/api/v1/proxies/{id}/usage

Расход ротационного доступа по часам (24h) или по дням (7d, 30d), в гигабайтах. У статических трафик не считается: metered = false.

Любой ключ

Параметры пути

idstringобязательно
Номер доступа.

Параметры запроса

periodstring
24h (по умолчанию), 7d или 30d.

В примере показаны два дня из семи.

Запрос
curl "https://proxly.org/api/v1/proxies/3f1c9a52-7b0e-4d2a-9c61-2f8e4b7d0a13/usage?period=7d" \
  -H "Authorization: Bearer pxl_your_key"
Ответ
{
  "ok": true,
  "data": {
    "proxy_id": "3f1c9a52-7b0e-4d2a-9c61-2f8e4b7d0a13",
    "period": "7d",
    "step": "day",
    "metered": true,
    "total_gb": 2.418,
    "series": [
      {
        "at": "2026-10-21T00:00:00.000Z",
        "gb": 0.312
      },
      {
        "at": "2026-10-22T00:00:00.000Z",
        "gb": 0.588
      }
    ]
  }
}

Новый пароль

POST/api/v1/proxies/{id}/password

Выдаёт новый случайный пароль; старый перестаёт работать сразу. Логин не меняется. У ISP и IPv4 один логин на весь заказ, поэтому пароль меняется у всех адресов этого заказа. В ответе — доступ с новым паролем.

Ключ «Чтение и покупки»

Параметры пути

idstringобязательно
Номер доступа.

Не чаще 5 раз в час на доступ (у ISP и IPv4 — на заказ, и до 20 в час на аккаунт). Для ISP и IPv4 нужна подтверждённая почта.

Запрос
curl "https://proxly.org/api/v1/proxies/3f1c9a52-7b0e-4d2a-9c61-2f8e4b7d0a13/password" \
  -H "Authorization: Bearer pxl_your_key" \
  -X POST
Ответ
{
  "ok": true,
  "data": {
    "id": "3f1c9a52-7b0e-4d2a-9c61-2f8e4b7d0a13",
    "type": "residential",
    "trial": false,
    "status": "active",
    "host": "78.153.130.98",
    "ports": {
      "http": 8080,
      "socks5": 8080,
      "https": 8443
    },
    "username": "r6bad7d204c",
    "password": "Tq84mZr2",
    "traffic": {
      "limit_gb": 10,
      "used_gb": 2.418,
      "remaining_gb": 7.582
    },
    "country": null,
    "order_id": "c2a9e0d4-51f3-4b8e-a7d6-0e3b9f12c845",
    "expires_at": null,
    "created_at": "2026-10-20T09:14:03.000Z"
  }
}

Заказы.

Заказы

GET/api/v1/orders

Заказы аккаунта, новые первыми, страницами. Следующая страница — с before = next_before из ответа.

Любой ключ

Параметры запроса

limitnumber
Сколько заказов на странице, 1–100, по умолчанию 50.
beforestring
next_before предыдущей страницы.

Поля ответа

itemsobject[]
Заказы страницы.
has_more, next_beforeboolean, string | null
Есть ли ещё заказы и что передать в before.
id, type, statusstring
Номер, вид прокси и состояние заказа (paid, provisioning, active, expired, refunded и другие).
gb, quantity, monthsnumber | null
Объём ротационного заказа или число адресов и месяцев статического.
price_rubnumber
Сколько заплачено в рублях.
access_order_idstring
Заказ доступа, которому достались гигабайты: при доливе — прежний заказ, иначе этот же. Ищите доступ в GET /proxies по order_id.
Запрос
curl "https://proxly.org/api/v1/orders?limit=20" \
  -H "Authorization: Bearer pxl_your_key"
Ответ
{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "c2a9e0d4-51f3-4b8e-a7d6-0e3b9f12c845",
        "type": "residential",
        "status": "active",
        "gb": 10,
        "quantity": null,
        "months": null,
        "country": null,
        "price_rub": 900,
        "trial": false,
        "access_order_id": "c2a9e0d4-51f3-4b8e-a7d6-0e3b9f12c845",
        "created_at": "2026-10-20T09:13:58.000Z",
        "updated_at": "2026-10-20T09:14:03.000Z"
      }
    ],
    "has_more": false,
    "next_before": null
  }
}

Один заказ

GET/api/v1/orders/{id}

Заказ по номеру — например, чтобы дождаться выдачи после покупки.

Любой ключ

Параметры пути

idstringобязательно
Номер заказа.
Запрос
curl "https://proxly.org/api/v1/orders/c2a9e0d4-51f3-4b8e-a7d6-0e3b9f12c845" \
  -H "Authorization: Bearer pxl_your_key"
Ответ
{
  "ok": true,
  "data": {
    "id": "c2a9e0d4-51f3-4b8e-a7d6-0e3b9f12c845",
    "type": "residential",
    "status": "active",
    "gb": 10,
    "quantity": null,
    "months": null,
    "country": null,
    "price_rub": 900,
    "trial": false,
    "access_order_id": "c2a9e0d4-51f3-4b8e-a7d6-0e3b9f12c845",
    "created_at": "2026-10-20T09:13:58.000Z",
    "updated_at": "2026-10-20T09:14:03.000Z"
  }
}

Купить трафик

POST/api/v1/orders

Покупка гигабайт Residential или Datacenter с баланса аккаунта. Если подходящий доступ этого вида уже есть, гигабайты добавляются к нему — логин и пароль не меняются; так ли вышло, скажут topped_up и access_order_id. Нужен ключ «Чтение и покупки» и подтверждённая почта.

Ключ «Чтение и покупки»

Заголовки

Idempotency-Keystringобязательно
Ваш уникальный номер покупки: 8–128 латинских букв, цифр и знаков без пробелов, например UUID. Повтор с тем же номером не спишет деньги второй раз и вернёт тот же заказ.

Тело запроса (JSON)

typestringобязательно
residential или datacenter.
gbnumberобязательно
Целое число ГБ в пределах min_gb–max_gb из GET /products.
currencystring
RUB (по умолчанию) или USD — по какому прайсу считать цену. Списывается всегда в рублях.
promo_codestring
Промокод, если есть.

Поля ответа

order_idstring
Номер нового заказа.
price_rub, discount_rub, charged_rubnumber
Цена без скидки, скидка и сколько списано с баланса.
balance_rubnumber
Баланс после покупки.
topped_up, access_order_idboolean, string
true — гигабайты добавлены к уже существующему доступу; access_order_id — order_id этого доступа в GET /proxies.
statusstring
Состояние заказа сразу после оплаты: paid, provisioning или active.
replayedboolean
true — это повтор запроса с тем же Idempotency-Key (ответ 200 вместо 201).

Доступ выдаётся за секунды. Пока заказ в статусе paid или provisioning, проверяйте его через GET /orders/{id}.

curl "https://proxly.org/api/v1/orders" \
  -X POST \
  -H "Authorization: Bearer pxl_your_key" \
  -H "Idempotency-Key: 7d1f0c2e-buy-10gb" \
  -H "Content-Type: application/json" \
  -d '{"type":"residential","gb":10}'
Ответ
{
  "ok": true,
  "data": {
    "order_id": "e41b7c09-2d5a-4f6e-8b13-9a0c7e2f5d61",
    "type": "residential",
    "gb": 10,
    "price_rub": 900,
    "discount_rub": 0,
    "charged_rub": 900,
    "balance_rub": 1100,
    "topped_up": true,
    "access_order_id": "c2a9e0d4-51f3-4b8e-a7d6-0e3b9f12c845",
    "status": "paid",
    "replayed": false
  }
}

White-label Soon

Продажа прокси Proxly под вашим брендом: свои клиенты, свои цены и подаккаунты с отдельными лимитами трафика. Хотите одними из первых — напишите в @proxly_sup.