API

Parameters

apiKey
String
Required
Your api key to access darth 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 (149 / 149)

Brazil
Proxies: 2152
Indonesia
Proxies: 2073
India
Proxies: 1876
Russian Federation
Proxies: 1337
United States
Proxies: 851
Bangladesh
Proxies: 824
Thailand
Proxies: 619
China
Proxies: 546
Ukraine
Proxies: 522
Colombia
Proxies: 348
Iran
Proxies: 326
France
Proxies: 321
Poland
Proxies: 285
Argentina
Proxies: 281
Cambodia
Proxies: 280
Ecuador
Proxies: 238
Turkey
Proxies: 229
Mexico
Proxies: 220
South Africa
Proxies: 214
Czech Republic
Proxies: 174
Bulgaria
Proxies: 152
Serbia
Proxies: 151
Spain
Proxies: 146
Vietnam
Proxies: 131
Korea
Proxies: 130
Nepal
Proxies: 124
Italy
Proxies: 112
Albania
Proxies: 109
Netherlands
Proxies: 108
Pakistan
Proxies: 104
Chile
Proxies: 102
Germany
Proxies: 91
Georgia
Proxies: 89
Iraq
Proxies: 88
Philippines
Proxies: 85
Hungary
Proxies: 76
United Kingdom
Proxies: 70
Hong Kong
Proxies: 68
Romania
Proxies: 65
Nigeria
Proxies: 63
Moldova
Proxies: 62
Lebanon
Proxies: 61
Armenia
Proxies: 61
Canada
Proxies: 58
Slovakia
Proxies: 58
Singapore
Proxies: 58
Malaysia
Proxies: 56
Kenya
Proxies: 56
Taiwan
Proxies: 50
Mongolia
Proxies: 45
Kazakhstan
Proxies: 44
Peru
Proxies: 41
Honduras
Proxies: 40
Lithuania
Proxies: 37
Venezuela
Proxies: 34
Australia
Proxies: 31
Guatemala
Proxies: 30
Paraguay
Proxies: 29
Palestine
Proxies: 28
Kyrgyzstan
Proxies: 27
Latvia
Proxies: 26
Libyan Arab Jamahiriya
Proxies: 25
Bolivia
Proxies: 25
Greece
Proxies: 24
Belarus
Proxies: 22
Myanmar
Proxies: 21
Seychelles
Proxies: 21
Japan
Proxies: 21
Unknown
Proxies: 20
Austria
Proxies: 20
Puerto Rico
Proxies: 18
Malawi
Proxies: 18
Croatia (Hrvatska)
Proxies: 16
Bosnia and Herzegovina
Proxies: 16
Panama
Proxies: 15
Slovenia
Proxies: 15
Syria
Proxies: 15
Israel
Proxies: 14
Cameroon
Proxies: 14
Portugal
Proxies: 14
Egypt
Proxies: 13
Cyprus
Proxies: 13
Costa Rica
Proxies: 13
Azerbaijan
Proxies: 12
Mozambique
Proxies: 12
Norway
Proxies: 12
Macedonia
Proxies: 12
Uganda
Proxies: 11
Somalia
Proxies: 11
Congo The Democratic Republic of The
Proxies: 11
Botswana
Proxies: 11
Switzerland
Proxies: 11
Zimbabwe
Proxies: 10
Guinea
Proxies: 10
Angola
Proxies: 10
Uruguay
Proxies: 9
Tanzania
Proxies: 8
Afghanistan
Proxies: 8
United Arab Emirates
Proxies: 8
Denmark
Proxies: 8
Saudi Arabia
Proxies: 7
Benin
Proxies: 7
Nicaragua
Proxies: 7
Namibia
Proxies: 7
Congo
Proxies: 6
Sweden
Proxies: 6
New Zealand
Proxies: 6
Dominican Republic
Proxies: 6
Tajikistan
Proxies: 5
Gabon
Proxies: 5
Maldives
Proxies: 5
Montenegro
Proxies: 5
Ireland
Proxies: 5
Ghana
Proxies: 5
Lesotho
Proxies: 5
Laos
Proxies: 4
Malta
Proxies: 4
Madagascar
Proxies: 4
Mali
Proxies: 4
Sierra Leone
Proxies: 4
Kuwait
Proxies: 4
Jamaica
Proxies: 3
Burkina Faso
Proxies: 3
Samoa
Proxies: 3
Burundi
Proxies: 3
Rwanda
Proxies: 3
Algeria
Proxies: 2
Kosovo
Proxies: 2
Finland
Proxies: 2
Estonia
Proxies: 2
Liberia
Proxies: 2
Jordan
Proxies: 2
Oman
Proxies: 2
Djibouti
Proxies: 2
Belgium
Proxies: 2
Mauritius
Proxies: 2
Zambia
Proxies: 1
Luxembourg
Proxies: 1
El Salvador
Proxies: 1
Bhutan
Proxies: 1
Sint Maarten
Proxies: 1
Guam
Proxies: 1
Papua New Guinea
Proxies: 1
Macau
Proxies: 1
Swaziland
Proxies: 1
Equatorial Guinea
Proxies: 1
Chad
Proxies: 1
Virgin Islands (U.S.)
Proxies: 1
Niger
Proxies: 1
May the proxy be with you, always.