API

Parameters

apiKey
String
Required
Your api key to access premium proxy list. To get this key open your dashboard page.
amount
Number
Optional
Select amount of proxies equal to value.

If this parameter is not specified will select all proxies.
uptime
Number
Optional
Select proxies with uptime percent more or equal to value.
Allowed value between 1 and 100.

If this parameter is not specified or value equal to 1 will select all proxies.
streak
Number
Optional
Select proxies with count of successful checks in a row more or equal to value. Available only for alive proxies.
Allowed value between 1 and 100.

If this parameter is not specified or value equal to 1 will select all proxies.
all
Number
Optional
Select alive proxies and dead proxies.
Allowed value: 1.

If this parameter is not specified will select only alive proxies.
smart
Number
Optional
Will filter duplicate proxies with same output IP addresses and extract only one proxy with best parameters.
Allowed value: 1.

If this parameter is not specified will select all proxies.
timeout
Number
Optional
Select proxies with response time less or equal to value, in milliseconds.
Allowed value between 1 and 10000.

If this parameter is not specified or value equal to 10000, will select all proxies.
stable
Array of Numbers
Optional
Select proxies by connection stability gradation.
Allowed values: [1,2,3].

1 - High.
2 - Medium.
3 - Low.

Example: 1,2.

If this parameter is not specified or set all 3 values, will select all proxies.
services
Array of Numbers
Optional
Select proxies by available services: passed google search, passed telegram site.
Allowed values: [1,2].

1 - Google.
2 - Telegram.

Example: 2.

If this parameter is not specified will select all proxies.
anons
Array of Numbers
Optional
Select proxies by anonymity.
Allowed values: [1,2,3].

1 - Elite.
2 - Anonymous.
3 - Transparent.

Example: 1,2.

If this parameter is not specified or set all 3 values, will select all proxies.
protocols
Array of Numbers
Optional
Select proxies by protocols.
Allowed values: [1,2,3,4].

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

Example: 1,3.

If this parameter is not specified or set all 4 values, will select all proxies.
countries
Array of Strings
Optional
Select proxies by country.
Allowed all country codes available at the moment.

Example: BD,ID,US.

If this parameter is not specified will select all proxies.

Restrictions

For prevent abuse the service apply following restrictions:

10000 requests per day.
If you reached 10000 requests, you will get blocked for 2 days.
Please, test your software to avoid bans.

Allowed 2 full different IP addresses per day + 1 with same 2 last octets if using ipv4. For ipv6 (4 last subnets).

Example ipv4:
- 127.1.50.28, 127.1.67.32
- 10.23.157.17, 10.23.100.53

Example ipv6:
- 2001:0DB8:ABCD:0012:0000:0000:ABCD:0000, 2001:0DB8:ABCD:0012:FFFF:FFFF:FFFF:FFFF
- FE80:CD00:0000:CDEA:1257:0000:211E:729C, FE80:CD00:0000:CDEA:FFFF:FFFF:FFFF:FFFF

In summary allowed 4 IPs.
If you reach the limit, you will get 403 error with 'You already reach different IPs limit per day, retry from your old IP address.' message.

How to get my current using status, e.g. subscription expire, blocked status, current hits, IPs? See example below.
                

GET:

Endpoint:
https://api.openproxy.space/premium/details/

Full query:
https://api.openproxy.space/premium/details/:apiKey

Response data example (if you already used api today):
{
    "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
    }
}

Response data example (if not):
{
    "status": "new",
    "blocked": false,
    "access": {
        "stage": 2,
        "expireHuman": "Thu Sep 26 2019 15:27:56 GMT+0200 (GMT+02:00)",
        "expireTS": 1569500876137
    }
}

Blocked status example:
{
    "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
    }
}

Builder

GET:

Endpoint:
https://api.openproxy.space/premium/json

Full query:
https://api.openproxy.space/premium/json?apiKey=

Response data example:
[{
    "protocols": [
        1,
        2
    ],
    "services": {
        "google": false,
        "telegram": true
    },
    "uptime": 100,
    "ip": "127.0.0.1",
    "port": 3128,
    "anon": 3,
    "timeout": 5672,
    "country": "FR",
    "cascade": {
        "ip": "127.0.0.12",
        "country": "BD"
    },
    "stable": 1,
    "streak": 2,
    "updated": 1556703635795
}]

Build your query

Your Api Key

Timeout

10000 ms

Uptime

All

Services

Anonymity

Amount

All

Streak

All

Protocol

Response Type

Stable

Additional

Country (133 / 133)

Brazil
Proxies: 1152
India
Proxies: 1123
Indonesia
Proxies: 1108
Russian Federation
Proxies: 758
Bangladesh
Proxies: 465
United States
Proxies: 457
China
Proxies: 386
Thailand
Proxies: 373
Ukraine
Proxies: 259
Argentina
Proxies: 190
Colombia
Proxies: 181
Poland
Proxies: 171
Turkey
Proxies: 165
Cambodia
Proxies: 131
South Africa
Proxies: 123
Mexico
Proxies: 118
Ecuador
Proxies: 118
Vietnam
Proxies: 104
Spain
Proxies: 97
Czech Republic
Proxies: 90
Bulgaria
Proxies: 83
Serbia
Proxies: 81
Nepal
Proxies: 74
Albania
Proxies: 69
Pakistan
Proxies: 66
Korea
Proxies: 64
Iraq
Proxies: 56
France
Proxies: 55
Moldova
Proxies: 52
Italy
Proxies: 50
Germany
Proxies: 47
Hungary
Proxies: 46
Philippines
Proxies: 45
Armenia
Proxies: 44
Hong Kong
Proxies: 41
Canada
Proxies: 41
Romania
Proxies: 41
Georgia
Proxies: 39
Malaysia
Proxies: 39
Chile
Proxies: 39
Netherlands
Proxies: 36
Lebanon
Proxies: 35
United Kingdom
Proxies: 33
Slovakia
Proxies: 33
Nigeria
Proxies: 31
Taiwan
Proxies: 31
Kenya
Proxies: 30
Libyan Arab Jamahiriya
Proxies: 29
Lithuania
Proxies: 28
Mongolia
Proxies: 26
Maldives
Proxies: 26
Kazakhstan
Proxies: 25
Honduras
Proxies: 24
Singapore
Proxies: 24
Peru
Proxies: 22
Australia
Proxies: 22
Venezuela
Proxies: 19
Seychelles
Proxies: 19
Palestine
Proxies: 17
Croatia (Hrvatska)
Proxies: 15
Bolivia
Proxies: 14
United Arab Emirates
Proxies: 13
Paraguay
Proxies: 12
Belarus
Proxies: 12
Greece
Proxies: 11
Myanmar
Proxies: 11
Panama
Proxies: 11
Kyrgyzstan
Proxies: 10
Uganda
Proxies: 10
Malawi
Proxies: 10
Azerbaijan
Proxies: 10
Bosnia and Herzegovina
Proxies: 9
Portugal
Proxies: 9
Japan
Proxies: 9
Guatemala
Proxies: 9
Latvia
Proxies: 8
Norway
Proxies: 8
Austria
Proxies: 8
Egypt
Proxies: 8
Cameroon
Proxies: 7
Somalia
Proxies: 7
Cyprus
Proxies: 6
Botswana
Proxies: 6
Costa Rica
Proxies: 6
Benin
Proxies: 6
Mozambique
Proxies: 6
Nicaragua
Proxies: 6
Slovenia
Proxies: 5
Ireland
Proxies: 5
Finland
Proxies: 5
Afghanistan
Proxies: 5
Macedonia
Proxies: 5
Uruguay
Proxies: 5
Namibia
Proxies: 5
Guinea
Proxies: 4
Zimbabwe
Proxies: 4
Puerto Rico
Proxies: 4
Sweden
Proxies: 4
Congo The Democratic Republic of The
Proxies: 4
Sri Lanka
Proxies: 4
Dominican Republic
Proxies: 3
Belgium
Proxies: 3
Burkina Faso
Proxies: 3
Jamaica
Proxies: 3
Unknown
Proxies: 3
Gabon
Proxies: 3
Switzerland
Proxies: 3
Lesotho
Proxies: 2
New Zealand
Proxies: 2
Kosovo
Proxies: 2
Israel
Proxies: 2
Montenegro
Proxies: 2
Saudi Arabia
Proxies: 2
Congo
Proxies: 2
Tajikistan
Proxies: 2
Zambia
Proxies: 2
Macau
Proxies: 1
El Salvador
Proxies: 1
Malta
Proxies: 1
Djibouti
Proxies: 1
Sudan
Proxies: 1
Burundi
Proxies: 1
Mauritius
Proxies: 1
Guam
Proxies: 1
Virgin Islands (U.S.)
Proxies: 1
Mali
Proxies: 1
Algeria
Proxies: 1
Luxembourg
Proxies: 1
Laos
Proxies: 1
Guyana
Proxies: 1
Timor-leste
Proxies: 1
Chad
Proxies: 1
Sierra Leone
Proxies: 1
May the proxy be with you, always.