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 (146 / 146)

China
Proxies: 2959
Brazil
Proxies: 2073
Indonesia
Proxies: 1785
India
Proxies: 1465
Russian Federation
Proxies: 1087
United States
Proxies: 809
Bangladesh
Proxies: 774
Thailand
Proxies: 727
Ukraine
Proxies: 353
Colombia
Proxies: 262
Turkey
Proxies: 246
Argentina
Proxies: 244
Poland
Proxies: 228
Ecuador
Proxies: 216
Cambodia
Proxies: 213
South Africa
Proxies: 197
Mexico
Proxies: 169
Czech Republic
Proxies: 149
Spain
Proxies: 145
Vietnam
Proxies: 139
Bulgaria
Proxies: 113
Nepal
Proxies: 108
Serbia
Proxies: 105
Pakistan
Proxies: 104
Albania
Proxies: 101
France
Proxies: 92
Korea
Proxies: 88
Iraq
Proxies: 88
Germany
Proxies: 86
Netherlands
Proxies: 82
Hong Kong
Proxies: 76
Nigeria
Proxies: 73
Georgia
Proxies: 72
Italy
Proxies: 71
Chile
Proxies: 71
Philippines
Proxies: 71
Singapore
Proxies: 71
Hungary
Proxies: 62
Slovakia
Proxies: 62
Romania
Proxies: 57
Moldova
Proxies: 56
Armenia
Proxies: 56
Kenya
Proxies: 55
Canada
Proxies: 54
United Kingdom
Proxies: 51
Malaysia
Proxies: 49
Libyan Arab Jamahiriya
Proxies: 48
Taiwan
Proxies: 45
Lebanon
Proxies: 45
Venezuela
Proxies: 45
Honduras
Proxies: 41
Peru
Proxies: 39
Lithuania
Proxies: 34
Mongolia
Proxies: 33
Kazakhstan
Proxies: 29
Australia
Proxies: 29
Palestine
Proxies: 27
Guatemala
Proxies: 25
Japan
Proxies: 25
Paraguay
Proxies: 24
Belarus
Proxies: 24
Panama
Proxies: 22
Austria
Proxies: 20
Bolivia
Proxies: 20
Greece
Proxies: 17
Malawi
Proxies: 15
United Arab Emirates
Proxies: 15
Ireland
Proxies: 14
Puerto Rico
Proxies: 14
Kyrgyzstan
Proxies: 13
Bosnia and Herzegovina
Proxies: 13
Croatia (Hrvatska)
Proxies: 12
Portugal
Proxies: 12
Myanmar
Proxies: 12
Latvia
Proxies: 12
Sweden
Proxies: 12
Uganda
Proxies: 12
Cameroon
Proxies: 11
Norway
Proxies: 11
Egypt
Proxies: 11
Botswana
Proxies: 10
Maldives
Proxies: 10
Azerbaijan
Proxies: 10
Saudi Arabia
Proxies: 10
Congo The Democratic Republic of The
Proxies: 10
Cyprus
Proxies: 9
Angola
Proxies: 9
Congo
Proxies: 8
Benin
Proxies: 8
Costa Rica
Proxies: 7
Slovenia
Proxies: 7
Macedonia
Proxies: 7
Sierra Leone
Proxies: 6
Guinea
Proxies: 6
Afghanistan
Proxies: 6
Tanzania
Proxies: 6
Mozambique
Proxies: 6
Montenegro
Proxies: 5
Dominican Republic
Proxies: 5
Finland
Proxies: 5
Israel
Proxies: 5
Madagascar
Proxies: 5
Belgium
Proxies: 4
Somalia
Proxies: 4
New Zealand
Proxies: 4
Burkina Faso
Proxies: 4
Sri Lanka
Proxies: 4
Unknown
Proxies: 4
Uruguay
Proxies: 4
Zambia
Proxies: 4
Malta
Proxies: 3
El Salvador
Proxies: 3
Laos
Proxies: 3
Jamaica
Proxies: 3
Denmark
Proxies: 3
Tajikistan
Proxies: 3
Zimbabwe
Proxies: 3
Nicaragua
Proxies: 3
Ghana
Proxies: 3
Burundi
Proxies: 3
Yemen
Proxies: 3
Lesotho
Proxies: 2
Kosovo
Proxies: 2
Mali
Proxies: 2
Namibia
Proxies: 2
Niger
Proxies: 2
Switzerland
Proxies: 2
Fiji
Proxies: 1
Chad
Proxies: 1
Sint Maarten
Proxies: 1
Seychelles
Proxies: 1
Estonia
Proxies: 1
Djibouti
Proxies: 1
Gabon
Proxies: 1
Sudan
Proxies: 1
Equatorial Guinea
Proxies: 1
Uzbekistan
Proxies: 1
Liberia
Proxies: 1
Rwanda
Proxies: 1
Guam
Proxies: 1
Macau
Proxies: 1
Ivory Coast
Proxies: 1
Virgin Islands (U.S.)
Proxies: 1
Samoa
Proxies: 1
Luxembourg
Proxies: 1
Morocco
Proxies: 1
May the proxy be with you, always.