API

Параметры

apiKey
Строка
Обязательный
Ваш ключ API для доступа к премиум списку прокси. Для того чтобы получить этот ключ, откройте приборную панель.
amount
Число
Опциональный
Выберет количество прокси равное значению.

Если этот параметр не указан, то будут выбраны любые прокси.
uptime
Число
Опциональный
Выберет прокси с процентом непрерывной работы больше, или равно значению.
Допустимое значение от 1 до 100.

Если этот параметр не указан, или значение равно 1, то будут выбраны любые прокси.
streak
Число
Опциональный
Выберет прокси с количеством успешных проверок подряд больше, или равно значению. Доступно только для живых прокси.
Допустимое значение от 1 до 100.

Если этот параметр не указан, или значение равно 1, то будут выбраны любые прокси.
status
Число
Опциональный
Select proxes by current status.
Allowed values: 1,2,3.

1 - Alive.
2 - Dead.
3 - All (alive and dead).

If this parameter is not specified will be selected only alive proxies by default.
smart
Число
Опциональный
Будет фильтровать прокси с одинаковыми исходящими IP адресами и извлекать только один с лучшими параметрами.
Допустимое значение: 1.

Если этот параметр не указан, то будут выбраны любые прокси.
timeout
Число
Опциональный
Выберет прокси с временем ответа последней проверки меньше, или равному значению, в миллисекундах.
Допустимое значение от 1 до 10000.

Если этот параметр не указан, или значение равно 10000, то будут выбраны любые прокси.
timeoutAverage
Число
Опциональный
Выберет прокси со средним временем ответа из последних 10 проверок меньше, или равному значению, в миллисекундах.
Допустимое значение от 1 до 10000.

Если этот параметр не указан, или значение равно 10000, то будут выбраны любые прокси.
stable
Массив из Чисел
Опциональный
Выберет прокси по стабильности соединения последней проверки.
Допустимые значения: [0,1,2].

0 - Высокая.
1 - Средняя.
2 - Низкая.

Пример: 1,2.

Если этот параметр не указан, или заданы все 3 значения, то будут выбраны любые прокси.
stableAverage
Массив из Чисел
Опциональный
Выберет прокси по средней стабильности соединения из 10 последних проверок.
Допустимые значения: [0,1,2].

0 - Высокая.
1 - Средняя.
2 - Низкая.

Пример: 1,2.

Если этот параметр не указан, или заданы все 3 значения, то будут выбраны любые прокси.
protocols
Массив из Чисел
Опциональный
Выберет прокси по протоколам.
Допустимые значения: [1,2,3].

1 - Https.
2 - Socks4.
3 - Socks5.

Пример: 1,3.

Если этот параметр не указан, или заданы все 3 значения, то будут выбраны любые прокси.
countries
Массив из Строк
Опциональный
Выберет прокси по странам.
Все коды стран, доступные на данный момент.

Пример: BD,ID,US.

Если этот параметр не указан, то будут выбраны любые прокси.
excludeCountries
Массив из Строк
Опциональный
Будет исключать прокси с этими странами.
Все коды стран, доступные на данный момент.

Пример: BD,ID,US.

Если этот параметр не указан, то будут выбраны любые прокси.
ports
Массив из Чисел
Опциональный
Выберет прокси по портам.
Допустимые значения от 1 до 65535.

Пример: 80,8080,3128.

Если этот параметр не указан, то будут выбраны любые прокси.
quality
Число
Опциональный
Выберет прокси по количеству очков качества, рассчитаных из: стрика, средней стабильности из последних 10 проверок, среднего тайм-аута из последних 10 проверок, времени бесперебойной работы. Больше или равно значению.
Допустимое значение от 1 до 100.

Если этот параметр не указан, то будут выбраны любые прокси.
checksMore
Число
Опциональный
Выберет прокси по количеству проверок, больше или равно значению. Для определения старых прокси в базе данных.
Допустимое значение от 1 до 10000.

Если этот параметр не указан, то будут выбраны любые прокси.
checksLess
Число
Опциональный
Выберет прокси по количеству проверок, меньше или равно значению. Для определения новых прокси в базе данных.
Допустимое значение от 1 до 10000.

Если этот параметр не указан, то будут выбраны любые прокси.

Ограничения

Для предотвращения абуза нашего сервиса, применяются следующие правила:

10000 запросов в день.
Если вы превысили 10000 запросов, вы будете заблокированы на 2 дня.
Пожалуйста, тестируйте своё ПО, для избежания блокировок.

Разрешается 3 полностью разных IP адреса в день + 2 к 2-м последним октетам, если вы используете ipv4. Для ipv6 (4 последние подсети).

Пример ipv4:
- 127.1.50.28, 127.1.67.32, 127.1.38.156
- 10.23.157.17, 10.23.100.53, 10.23.120.1
- 60.25.117.10, 60.25.133.5, 60.25.213.117

Пример ipv6:
- 2001:0DB8:ABCD:0012:0000:0000:ABCD:0000, 2001:0DB8:ABCD:0012:FFFF:FFFF:FFFF:FFFF, 2001:0DB8:ABCD:0012:FFFF:CDEA:FFFF:FFFF
- FE80:CD00:0000:CDEA:1257:0000:211E:729C, FE80:CD00:0000:CDEA:FFFF:FFFF:FFFF:FFFF, FE80:CD00:0000:CDEA:FFFF:FFFF:0DB8:FFFF
- 5AEE:CD00:0000:ABCD:1257:0000:211E:729C, 5AEE:CD00:0000:ABCD:FFFF:FFFF:FFFF:FFFF, 5AEE:CD00:0000:ABCD:FFFF:FFFF:ABCD:FFFF

Суммарно разрешено 9 IP адресов.
Если вы превысите лимит, то вы получите ошибку 403 с сообщением 'You already reach different IPs limit per day, retry from your old IP address.'.

Как узнать мой текущий статус использования, например: окончание подписки, статус блокировки, текущее кол-во запросов, используемые IP адреса? Смотрите пример ниже.
                

GET:

Конечная точка:
https://api.openproxy.space/premium/details/

Полный запрос:
https://api.openproxy.space/premium/details/:apiKey

Пример ответа (если вы уже использовали API сегодня):
{
    "status": "used",
    "ts": 1567008457115,
    "ips": {
        "xx.xx": [
            "xx.xx.xxx.xx",
            "xx.xx.xxx.xxx"
        ],
        "xxx.xx": [
            "xxx.xx.xxx.xx",
            "xxx.xx.x.xxx"
        ]
    },
    "hits": {
        "used": 75,
        "total": 10000,
        "remaining": 9925
    },
    "blocked": false,
    "access": {
        "stage": 2,
        "expireHuman": "Thu Sep 26 2019 15:27:56 GMT+0200 (GMT+02:00)",
        "expireTS": 1569500876137
    }
}

Пример ответа (если нет):
{
    "status": "new",
    "blocked": false,
    "access": {
        "stage": 2,
        "expireHuman": "Thu Sep 26 2019 15:27:56 GMT+0200 (GMT+02:00)",
        "expireTS": 1569500876137
    }
}

Пример ответа с блокировкой:
{
    "blocked": {
        "status": true,
        "message": "You reached 10000 hits per day, looks like DOS attack.",
        "expireHuman": "Fri Aug 30 2019 19:07:56 GMT+0200 (GMT+02:00)",
        "expireTS": 1567181276642
    }
}

Конструктор

GET:

Конечная точка:
https://api.openproxy.space/premium/json

Полный запрос:
https://api.openproxy.space/premium/json?apiKey=&smart=1

Пример ответа:
[{
    "protocols": [
        1,
        2
    ],
    "uptime": 100,
    "ip": "127.0.0.1",
    "port": 3128,
    "quality": 92,
    "timeout": 5672,
    "country": "FR",
    "cascade": {
        "ip": "127.0.0.12",
        "country": "BD"
    },
    "stable": 1,
    "streak": 2,
    "updated": 1556703635795
}]

Соберите свой запрос

Ваш Api Ключ

Порты

Тайм-аут

  • Посл.
  • Средн.
10000 ms

Проверки

  • Боль.
  • Мень.
Все

Аптайм

Все

Количество

Все

Стрик

Все

Качество

Все

Дополнительно

Статус

Протокол

Стабильность

  • Посл.
  • Средн.

Тип Ответа

Страны (151 / 151)

China
Proxies: 4430
Brazil
Proxies: 2124
Indonesia
Proxies: 1798
India
Proxies: 1488
Russian Federation
Proxies: 992
Thailand
Proxies: 876
Bangladesh
Proxies: 727
United States
Proxies: 613
Ukraine
Proxies: 372
Colombia
Proxies: 255
Argentina
Proxies: 212
Turkey
Proxies: 208
Poland
Proxies: 203
South Africa
Proxies: 182
Ecuador
Proxies: 181
Vietnam
Proxies: 171
Spain
Proxies: 166
Cambodia
Proxies: 159
Mexico
Proxies: 142
Korea
Proxies: 133
Pakistan
Proxies: 118
Nepal
Proxies: 104
Serbia
Proxies: 101
Czech Republic
Proxies: 96
Albania
Proxies: 93
Bulgaria
Proxies: 91
Singapore
Proxies: 87
Hungary
Proxies: 79
Chile
Proxies: 78
Iraq
Proxies: 77
France
Proxies: 70
Italy
Proxies: 64
Germany
Proxies: 62
Philippines
Proxies: 60
Kenya
Proxies: 57
Netherlands
Proxies: 56
Malaysia
Proxies: 52
Canada
Proxies: 51
Hong Kong
Proxies: 51
Romania
Proxies: 50
Moldova
Proxies: 49
Georgia
Proxies: 46
Armenia
Proxies: 45
Taiwan
Proxies: 42
Slovakia
Proxies: 41
Palestine
Proxies: 40
Venezuela
Proxies: 39
Peru
Proxies: 36
Greece
Proxies: 35
Mongolia
Proxies: 33
Nigeria
Proxies: 33
United Kingdom
Proxies: 32
Kazakhstan
Proxies: 32
Maldives
Proxies: 31
Australia
Proxies: 29
Lithuania
Proxies: 28
Seychelles
Proxies: 27
Honduras
Proxies: 26
Libyan Arab Jamahiriya
Proxies: 25
Yemen
Proxies: 23
Croatia (Hrvatska)
Proxies: 21
Norway
Proxies: 20
Panama
Proxies: 18
Uganda
Proxies: 18
Bolivia
Proxies: 17
Japan
Proxies: 16
Cameroon
Proxies: 15
Myanmar
Proxies: 15
Unknown
Proxies: 15
Bosnia and Herzegovina
Proxies: 14
Macedonia
Proxies: 14
Puerto Rico
Proxies: 14
Paraguay
Proxies: 14
Portugal
Proxies: 13
Belarus
Proxies: 12
Lebanon
Proxies: 12
Malawi
Proxies: 12
Sweden
Proxies: 12
Botswana
Proxies: 11
Dominican Republic
Proxies: 10
Mozambique
Proxies: 10
Angola
Proxies: 9
Costa Rica
Proxies: 9
Guatemala
Proxies: 9
Slovenia
Proxies: 9
Austria
Proxies: 8
Kyrgyzstan
Proxies: 8
Ireland
Proxies: 8
Latvia
Proxies: 7
Somalia
Proxies: 7
New Zealand
Proxies: 7
Benin
Proxies: 6
Sri Lanka
Proxies: 6
Madagascar
Proxies: 6
Cyprus
Proxies: 6
Mauritius
Proxies: 6
United Arab Emirates
Proxies: 5
Egypt
Proxies: 5
Guinea
Proxies: 5
Tanzania
Proxies: 5
Uruguay
Proxies: 5
Zimbabwe
Proxies: 5
Denmark
Proxies: 5
Ghana
Proxies: 5
Congo The Democratic Republic of The
Proxies: 5
Afghanistan
Proxies: 4
Azerbaijan
Proxies: 4
Finland
Proxies: 4
Laos
Proxies: 4
Lesotho
Proxies: 4
Nicaragua
Proxies: 4
Congo
Proxies: 4
Israel
Proxies: 3
Mali
Proxies: 3
Gabon
Proxies: 3
Luxembourg
Proxies: 3
Belgium
Proxies: 3
Burkina Faso
Proxies: 3
Zambia
Proxies: 3
Central African Republic
Proxies: 2
Jamaica
Proxies: 2
Malta
Proxies: 2
Sierra Leone
Proxies: 2
Montenegro
Proxies: 2
Tajikistan
Proxies: 2
Uzbekistan
Proxies: 2
Virgin Islands (U.S.)
Proxies: 2
Kosovo
Proxies: 2
Burundi
Proxies: 2
Namibia
Proxies: 1
Timor-leste
Proxies: 1
Chad
Proxies: 1
Djibouti
Proxies: 1
Equatorial Guinea
Proxies: 1
Iran
Proxies: 1
New Caledonia
Proxies: 1
Saudi Arabia
Proxies: 1
Sudan
Proxies: 1
Trinidad and Tobago
Proxies: 1
Switzerland
Proxies: 1
Macau
Proxies: 1
Andorra
Proxies: 1
Bahrain
Proxies: 1
Haiti
Proxies: 1
Rwanda
Proxies: 1
Swaziland
Proxies: 1
El Salvador
Proxies: 1
Ethiopia
Proxies: 1
Guam
Proxies: 1
Kuwait
Proxies: 1
Papua New Guinea
Proxies: 1
Да пребудут с вами прокси, всегда.