Что даёт API
Каталог ChillProxy открыт и для программ: тот же список живых прокси, что на сайте, можно получить JSON-ом — для бота, для своего приложения или для автоматического переключения прокси в Telethon. Ключ не нужен. Интерактивная документация со всеми полями — на /api/docs.
Пример запроса
01
Пять самых стабильных EE-Mask прокси
Ответ — объект с массивом <code>servers</code>: у каждого сервера адрес, порт, секрет, тип, страна, город, пинг, аптайм и время последней проверки.
$
curl 'https://proxy-tlg.ru/search?ee_mask=true&sort=uptime&limit=5'
02
Соберите ссылку для Telegram
Из полей <code>ip</code>, <code>port</code> и <code>secret</code> — обычная ссылка tg://proxy. У WEB-прокси (<code>mask_type: web</code>) ссылка другая — tg://webproxy.
$
tg://proxy?server={ip}&port={port}&secret={secret}
Параметры /search
| Параметр | Что делает |
|---|---|
no_mask, dd_mask, ee_mask, web | Типы прокси: true — включить в выдачу. Без них — все типы |
country | Код страны сервера, например de |
max_ping | Максимальный пинг в мс, 0 — без ограничения |
sort | ping (по умолчанию), uptime или country |
limit, offset | Сколько вернуть (1–200, по умолчанию 50) и сколько пропустить |
search | Поиск по части адреса, секрета или SNI |
Все методы
| Метод | Для чего |
|---|---|
GET /search | Живые прокси с фильтрами — основной метод |
GET /countries | Страны, для которых в каталоге есть прокси |
POST /api/probe | Проверить свой прокси настоящим подключением (до 20 проверок в минуту) |
POST /api/submit-proxy | Добавить прокси в каталог (до 5 заявок за 10 минут) |
POST /api/submit-batch | Добавить список до 50 ссылок (до 3 списков за 10 минут) |
Честное использование
Список обновляется примерно раз в 10 минут, поэтому запрашивать его чаще раза в минуту бессмысленно — кэшируйте ответ у себя. Если делаете на основе API публичный сервис, будем рады ссылке на proxy-tlg.ru. Страна и город серверов определяются по базе IP Geolocation by DB-IP (CC BY 4.0).
FAQ
Нужен ли ключ API?
Нет. Методы чтения открыты; на проверку и добавление прокси действуют лимиты на количество запросов.
Как часто обновляются данные?
Примерно каждые 10 минут: каждый сервер перепроверяется настоящим подключением к Telegram. Поле last_check_at показывает время последней проверки.
Можно ли использовать API в Telegram-боте?
Да. Только учтите: сами MTProto-прокси подходят для Telethon, но не для ботов на Bot API — подробнее в статье <a href="/proxy-dlya-telegram-bota">«Прокси для Telegram-бота»</a>.