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 be selected any 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 be selected any proxies.
streak
Number
Optional
Select proxies by 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 be selected any proxies.
status
Number
Optional
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
Number
Optional
Will filter multiple proxies with same output (real) IPs and extract only best one proxy.
Allowed value: 1.

If this parameter is not specified will be selected any proxies.
timeout
Number
Optional
Select proxies by response time of the last checking, 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 be selected any proxies.
timeoutAverage
Number
Optional
Select proxies by average response time of the last 10 checkings, 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 be selected any proxies.
stable
Array of Numbers
Optional
Select proxies by stability gradation of the last connection.
Allowed values: [0,1,2].

0 - High.
1 - Medium.
2 - Low.

Example: 1,2.

If this parameter is not specified or set all 3 values, will be selected any proxies.
stableAverage
Array of Numbers
Optional
Select proxies by average stability gradation of the last 10 connections.
Allowed values: [0,1,2].

0 - High.
1 - Medium.
2 - Low.

Example: 1,2.

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

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

Example: 1,3.

If this parameter is not specified or set all 3 values, will be selected any 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 be selected any proxies.
excludeCountries
Array of Strings
Optional
Will exclude proxies with these countries.
Allowed all country codes available at the moment.

Example: BD,ID,US.

If this parameter is not specified will be selected any proxies.
ports
Array of Numbers
Optional
Select proxies by ports.
Allowed values between 1 and 65535.

Example: 80,8080,3128.

If this parameter is not specified will be selected any proxies.
quality
Number
Optional
Select proxies by calculated quality score from: streak, average stable of 10 last checks, average timeout of 10 last checks, uptime. More or equal to value.
Allowed value between 1 and 100.

If this parameter is not specified will be selected any proxies.
checksMore
Number
Optional
Select proxies by total checks, more or equal to value. To determine old proxies in database.
Allowed value between 1 and 10000.

If this parameter is not specified will be selected any proxies.
checksLess
Number
Optional
Select proxies by total checks, less or equal to value. To determine new proxies in database.
Allowed value between 1 and 10000.

If this parameter is not specified will be selected any proxies.
filename
String
Optional
If specified will download a file instead of plain text response.
Allowed charsets: a-z A-Z 0-9 _ - (space).
File extension will sets automatically.

Example: "save me".
Will be saved as "save me.txt" or "save me.json".

If this parameter is not specified will be returned a plain text response.

Restrictions

For prevent abuse the service apply following restrictions:

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

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

Example 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

Example 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

In summary allowed 9 IPs.
If you reach the limit, you will get 403 error with 'You have reached the IP limits 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 using the API or Web-Interface 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=&smart=1

Response data example:
[{
    "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
}]

Build your query

Your Api Key

Ports

Filename

Timeout

  • Last
  • Average
10000 ms

Checks

  • More
  • Less
All

Uptime

All

Amount

All

Streak

All

Quality

All

Additional

Status

Protocol

Stable

  • Last
  • Average

Response Type

Country (156 / 156)

Indonesia
Proxies: 2390
Brazil
Proxies: 2240
India
Proxies: 1871
Bangladesh
Proxies: 998
China
Proxies: 877
Iran
Proxies: 814
Russian Federation
Proxies: 747
Ukraine
Proxies: 735
Poland
Proxies: 581
Colombia
Proxies: 543
United States
Proxies: 526
Cambodia
Proxies: 516
Argentina
Proxies: 508
South Africa
Proxies: 505
Unknown
Proxies: 485
Thailand
Proxies: 478
Vietnam
Proxies: 336
Ecuador
Proxies: 268
Italy
Proxies: 261
Turkey
Proxies: 251
Spain
Proxies: 248
Czech Republic
Proxies: 239
Nepal
Proxies: 232
Kenya
Proxies: 200
Pakistan
Proxies: 168
Nigeria
Proxies: 166
Mexico
Proxies: 158
Bulgaria
Proxies: 153
Iraq
Proxies: 145
Chile
Proxies: 131
Serbia
Proxies: 118
Peru
Proxies: 98
Albania
Proxies: 92
Georgia
Proxies: 90
Myanmar
Proxies: 87
Palestine
Proxies: 87
Hungary
Proxies: 86
Philippines
Proxies: 86
Kazakhstan
Proxies: 80
Honduras
Proxies: 77
Bolivia
Proxies: 76
Romania
Proxies: 74
Venezuela
Proxies: 73
Mongolia
Proxies: 73
Germany
Proxies: 69
Slovakia
Proxies: 60
Bosnia and Herzegovina
Proxies: 57
Canada
Proxies: 55
Uganda
Proxies: 54
Tanzania
Proxies: 53
Guatemala
Proxies: 52
Moldova
Proxies: 50
France
Proxies: 50
United Kingdom
Proxies: 49
Australia
Proxies: 49
Armenia
Proxies: 47
Paraguay
Proxies: 45
Latvia
Proxies: 43
Korea
Proxies: 38
Afghanistan
Proxies: 38
Singapore
Proxies: 36
Malawi
Proxies: 35
Lebanon
Proxies: 33
Taiwan
Proxies: 33
Kyrgyzstan
Proxies: 32
Lithuania
Proxies: 32
Cameroon
Proxies: 32
Libyan Arab Jamahiriya
Proxies: 32
Austria
Proxies: 31
Dominican Republic
Proxies: 31
Congo The Democratic Republic of The
Proxies: 31
Japan
Proxies: 31
Malaysia
Proxies: 30
Zimbabwe
Proxies: 29
Costa Rica
Proxies: 29
Hong Kong
Proxies: 28
Seychelles
Proxies: 28
Belarus
Proxies: 25
Botswana
Proxies: 25
Egypt
Proxies: 25
Benin
Proxies: 24
Nicaragua
Proxies: 23
Azerbaijan
Proxies: 23
Mozambique
Proxies: 22
Netherlands
Proxies: 22
Croatia (Hrvatska)
Proxies: 21
Israel
Proxies: 20
Greece
Proxies: 20
Guinea
Proxies: 19
Ghana
Proxies: 19
Panama
Proxies: 18
Maldives
Proxies: 17
Ireland
Proxies: 16
Mauritius
Proxies: 16
Slovenia
Proxies: 16
Puerto Rico
Proxies: 16
Madagascar
Proxies: 15
Uzbekistan
Proxies: 14
Togo
Proxies: 14
Burundi
Proxies: 14
Uruguay
Proxies: 14
Belize
Proxies: 13
Equatorial Guinea
Proxies: 13
Cyprus
Proxies: 13
Angola
Proxies: 12
Zambia
Proxies: 12
Congo
Proxies: 12
Norway
Proxies: 11
Portugal
Proxies: 11
New Zealand
Proxies: 11
Rwanda
Proxies: 11
Montenegro
Proxies: 11
Malta
Proxies: 10
Laos
Proxies: 10
Somalia
Proxies: 10
Sweden
Proxies: 9
Macedonia
Proxies: 9
Andorra
Proxies: 9
Estonia
Proxies: 7
Denmark
Proxies: 7
Finland
Proxies: 6
Saint Martin
Proxies: 6
Tajikistan
Proxies: 6
Saudi Arabia
Proxies: 6
Namibia
Proxies: 5
New Caledonia
Proxies: 5
Switzerland
Proxies: 5
Lesotho
Proxies: 5
Papua New Guinea
Proxies: 4
Bhutan
Proxies: 4
Cape Verde
Proxies: 4
United Arab Emirates
Proxies: 4
Burkina Faso
Proxies: 3
Mali
Proxies: 3
Chad
Proxies: 3
South Sudan
Proxies: 3
Timor-leste
Proxies: 3
Sierra Leone
Proxies: 2
Virgin Islands (U.S.)
Proxies: 2
Macau
Proxies: 2
Sudan
Proxies: 2
Mauritania
Proxies: 2
Liberia
Proxies: 2
Iceland
Proxies: 1
Djibouti
Proxies: 1
Syria
Proxies: 1
Algeria
Proxies: 1
Gambia
Proxies: 1
Ivory Coast
Proxies: 1
Bahrain
Proxies: 1
Belgium
Proxies: 1
Trinidad and Tobago
Proxies: 1
Luxembourg
Proxies: 1
Aland Islands
Proxies: 1
Samoa
Proxies: 1
Fiji
Proxies: 1
May the proxy be with you, always.