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/darth/details/

Full query:
https://api.openproxy.space/darth/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/darth/json

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

Response data example:
[{
    "protocols": [
        1,
        2
    ],
    "services": [
        1
    ],
    "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 (156 / 156)

Brazil
Proxies: 2580
India
Proxies: 2453
Indonesia
Proxies: 2332
Russian Federation
Proxies: 1446
United States
Proxies: 1251
Bangladesh
Proxies: 1045
Thailand
Proxies: 941
China
Proxies: 713
Ukraine
Proxies: 549
Iran
Proxies: 371
Colombia
Proxies: 370
Netherlands
Proxies: 356
Argentina
Proxies: 348
Poland
Proxies: 332
Cambodia
Proxies: 300
Turkey
Proxies: 287
Ecuador
Proxies: 277
Mexico
Proxies: 276
South Africa
Proxies: 275
Spain
Proxies: 202
Czech Republic
Proxies: 187
Vietnam
Proxies: 164
Bulgaria
Proxies: 162
France
Proxies: 156
Nepal
Proxies: 152
Pakistan
Proxies: 151
Singapore
Proxies: 148
Korea
Proxies: 142
Serbia
Proxies: 137
Iraq
Proxies: 121
Albania
Proxies: 108
Germany
Proxies: 103
Chile
Proxies: 100
Georgia
Proxies: 95
Italy
Proxies: 95
Nigeria
Proxies: 94
Slovakia
Proxies: 87
Philippines
Proxies: 84
Hungary
Proxies: 83
Armenia
Proxies: 82
Kenya
Proxies: 81
Romania
Proxies: 70
Canada
Proxies: 70
United Kingdom
Proxies: 69
Lebanon
Proxies: 68
Taiwan
Proxies: 63
Hong Kong
Proxies: 63
Moldova
Proxies: 62
Malaysia
Proxies: 61
Libyan Arab Jamahiriya
Proxies: 52
Venezuela
Proxies: 48
Mongolia
Proxies: 45
Lithuania
Proxies: 43
Seychelles
Proxies: 43
Honduras
Proxies: 41
Kazakhstan
Proxies: 40
Peru
Proxies: 40
Australia
Proxies: 36
Palestine
Proxies: 35
Japan
Proxies: 27
Latvia
Proxies: 26
Paraguay
Proxies: 26
Myanmar
Proxies: 24
Austria
Proxies: 23
Malawi
Proxies: 23
Bolivia
Proxies: 22
Guatemala
Proxies: 22
Kyrgyzstan
Proxies: 21
Egypt
Proxies: 21
Puerto Rico
Proxies: 20
Belarus
Proxies: 20
Panama
Proxies: 19
Norway
Proxies: 18
Bosnia and Herzegovina
Proxies: 18
Greece
Proxies: 18
Costa Rica
Proxies: 16
Croatia (Hrvatska)
Proxies: 15
Uganda
Proxies: 15
Syria
Proxies: 15
Mozambique
Proxies: 14
Cameroon
Proxies: 14
Portugal
Proxies: 14
United Arab Emirates
Proxies: 14
Guinea
Proxies: 14
Macedonia
Proxies: 13
Azerbaijan
Proxies: 12
Slovenia
Proxies: 12
Botswana
Proxies: 12
Angola
Proxies: 12
Unknown
Proxies: 12
Tanzania
Proxies: 12
Namibia
Proxies: 11
Ireland
Proxies: 11
Congo The Democratic Republic of The
Proxies: 11
Yemen
Proxies: 11
Dominican Republic
Proxies: 10
Zimbabwe
Proxies: 10
Switzerland
Proxies: 10
Cyprus
Proxies: 10
Saudi Arabia
Proxies: 9
Maldives
Proxies: 9
Afghanistan
Proxies: 9
Somalia
Proxies: 9
Uruguay
Proxies: 8
Sweden
Proxies: 6
Benin
Proxies: 6
Malta
Proxies: 6
New Zealand
Proxies: 6
Nicaragua
Proxies: 6
Laos
Proxies: 6
Congo
Proxies: 6
Ghana
Proxies: 6
Burkina Faso
Proxies: 5
Madagascar
Proxies: 5
Montenegro
Proxies: 5
Finland
Proxies: 5
Burundi
Proxies: 5
Sierra Leone
Proxies: 5
Lesotho
Proxies: 5
Niger
Proxies: 5
Sri Lanka
Proxies: 5
Tajikistan
Proxies: 4
Gabon
Proxies: 4
Israel
Proxies: 4
Mali
Proxies: 4
Denmark
Proxies: 4
Belgium
Proxies: 4
Luxembourg
Proxies: 4
Jamaica
Proxies: 3
Liberia
Proxies: 3
Jordan
Proxies: 3
Kosovo
Proxies: 2
Djibouti
Proxies: 2
Algeria
Proxies: 2
Swaziland
Proxies: 2
Estonia
Proxies: 1
Sudan
Proxies: 1
Tunisia
Proxies: 1
El Salvador
Proxies: 1
Bhutan
Proxies: 1
Sint Maarten
Proxies: 1
Guam
Proxies: 1
Samoa
Proxies: 1
Barbados
Proxies: 1
Macau
Proxies: 1
Kuwait
Proxies: 1
Chad
Proxies: 1
Virgin Islands (U.S.)
Proxies: 1
Mauritius
Proxies: 1
Zambia
Proxies: 1
Andorra
Proxies: 1
Fiji
Proxies: 1
Trinidad and Tobago
Proxies: 1
Rwanda
Proxies: 1
Timor-leste
Proxies: 1
Ivory Coast
Proxies: 1
May the proxy be with you, always.