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