nLevel - Прокси API
nLevel - Прокси API предоставляет простой и удобный способ для автоматизированного получения списков публичных прокси. Используйте его для интеграции в ваши приложения и скрипты.
Конечная точка API
Для получения доступа к прокси используйте следующий HTTP GET запрос:
format=text — строки в формате IP:PORT (при нескольких типах — IP:PORT|TYPE), по одной на каждую прокси.
format=json — структурированный ответ с полями message и proxies, на которые уже применены все фильтры.
Параметры запроса
Для настройки вашего запроса используйте следующую таблицу параметров:
| Параметр | Статус | Описание и примеры |
|---|---|---|
key | Обязательный | Ваш уникальный ключ доступа к API nLevel - Прокси. Пример: key=pk_xxxxxxxxx. |
type | Обязательный | Один или несколько типов прокси через запятую. Пример: type=http,socks5. |
format | Необязательный | Управляет форматом ответа. Значение по умолчанию — text. Укажите format=json, чтобы получить объект с полями message и proxies. |
filter | Множественный | Фильтрация результата по схеме поле:значение. Допускается несколько параметров filter в одном запросе. Примеры: filter=geo.country:DE, filter=responseTimeMs:250, filter=geo.city:*. |
Параметр filter можно указывать несколько раз. Фильтрация выполняется как для текстового, так и для JSON-ответа, поэтому итоговый список всегда соответствует заданным условиям. Используйте точечную нотацию для вложенных полей (например, filter=geo.city:Berlin), а значение * проверяет наличие непустого значения.
Доступные типы прокси
Вы можете запрашивать следующие типы прокси:
| Тип | Описание |
|---|---|
HTTP | Подходят для большинства задач веб-серфинга и работают по протоколу HTTP. |
HTTPS | Предоставляют шифрование трафика между клиентом и прокси-сервером. |
SOCKS4 | Работают на более низком уровне, чем HTTP, поддерживают TCP соединения. |
SOCKS5 | Самый гибкий вариант: поддерживает TCP/ UDP и различные методы аутентификации. |
В рамках nLevel - Прокси, типы HTTP и HTTPS обрабатываются как единая категория HTTP/HTTPS. Если вы укажете http, https, или http,https в параметре type, вы получите смешанный список прокси обоих этих типов.
Форматы ответа
Текстовый режим ( format=text)
Файл содержит только прокси. Формат строк зависит от количества выбранных типов: IP:PORT для одного типа и IP:PORT|TYPE, если форматы смешаны.
JSON режим ( format=json)
Ответ представляет собой объект с полем message и массивом proxies. Записи содержат обязательные поля ( ip, port, type) и дополнительные свойства вроде responseTimeMs и блока geo. Никаких служебных метаданных и статистики в выдаче нет — только данные о прокси.
Используйте точечную нотацию в параметрах filter для вложенных полей (например, filter=geo.city:Berlin), а значение * проверяет наличие непустого поля.
Полный справочник полей
Структура JSON содержит статус message и массив proxies. Каждый объект прокси может включать базовые поля и дополнительные сведения, если они есть в источнике.
Поля верхнего уровня
| Поле | Тип | Описание |
|---|---|---|
message | string | Статус запроса (например, success). |
proxies | Proxy[] | Массив объектов прокси после применения фильтров. |
Поля объекта Proxy
| Поле | Тип | Описание |
|---|---|---|
ip | string | IPv4-адрес узла, через который будут идти запросы. |
port | number | Порт, на котором прокси принимает подключения клиентов. |
type | string | Нормализованный тип протокола: HTTP/ HTTPS, SOCKS4 или SOCKS5. |
anonymity | string | Классификация уровня анонимности, которую возвращает источник (например, anonymous, elite). |
responseTimeMs | number | Средний отклик прокси в миллисекундах по данным последнего health-check. |
successfulChecks | number | Сколько раз подряд прокси подтверждал работоспособность. |
geo | object | Структурированный блок с геоданными (страна, регион, город, координаты и др.), который автоматически вычисляется и нормализуется. |
Поля объекта geo
| Поле | Тип | Описание |
|---|---|---|
country | string | ISO-код страны, определённый после нормализации данных. |
region | string | Регион или штат, к которому относится IP. |
city | string | Город расположения прокси. |
latitude | number | Географическая широта в градусах. |
longitude | number | Географическая долгота в градусах. |
timezone | string | Часовой пояс, определённый для IP-адреса. |
isp | string | Провайдер или оператор связи, обслуживающий IP. |
organization | string | Организация-владелец подсети, если известна. |
asn | string | Номер автономной системы (ASN). |