Skip to content

Commit

Permalink
Updated at 2024-04-13 19:40:00
Browse files Browse the repository at this point in the history
  • Loading branch information
prxchk committed Apr 13, 2024
0 parents commit c59e9b4
Show file tree
Hide file tree
Showing 9 changed files with 426 additions and 0 deletions.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
*.tmp
164 changes: 164 additions & 0 deletions API.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,164 @@
# [DRAFT] PRXCHK API

> [!TIP]
> To use our API, you will need a token, which can be obtained through our Telegram bot.
To obtain a list of available proxies, you need to make a GET request to the
address `https://api.prxchk.com/v2/proxies.txt`

First and foremost, it is important to remember that every request must include an access token. If you pass an empty,
incorrect, or expired token, the system will automatically add your IP address to a blacklist, and you will lose access
to the service. To successfully authenticate, you need to pass the token as a request parameter or an HTTP header:

> [!CAUTION]
> The token `AQBA5gEABCDEFDobwmAxV3XTSrDpU7bxaEaeeM2Wg` is used as a demonstration example. Please **DO NOT ATTEMPT TO USE IT** in your requests. Doing so may result in permanent blocking of your IP address 🤕
```bash
# strongly recommend to use HTTP-header
curl -H "Token: AQBA5gEABCDEFDobwmAxV3XTSrDpU7bxaEaeeM2Wg" https://api.prxchk.com/v2/proxies.txt

# it is possible to use the query parameter, but it is not secure enough
curl https://api.prxchk.com/v2/proxies.txt?token=AQBA5gEABCDEFDobwmAxV3XTSrDpU7bxaEaeeM2Wg
```

To prevent abuse of our service, we have implemented strict restrictions and automatically bind the token to the
sender's IP address. This limitation is in effect for 24 hours and prevents the token from being disclosed. In order to
reduce the load on our service, we also impose a limitation on the number of requests.

> ⚠️ The **optimal limit** is no more than **50 requests per minute**
> ⛔ The **maximum limit** is no more than **1000 requests per hour**
In case of systematic violation of the limitations, you risk losing the ability to use the service.

## Params

| Param | Available |
|------------|------------------------------------------------------------|
| with_proto | _isset_ |
| json | _isset_ |
| protocol | `http`, `socks4`, `socks5` |
| country | _iso2 country code_ like `US`, `DE`, etc. |
| anonymity | `elite` or `anonymous` |
| port | _int between 1 and 65535_ |
| order | `uptime`, `stability`, `updated_at`, `timeout` or `random` |
| limit | _int between 1 and 1000_ |

By default, the request returns all available proxies in TXT-format without specifying the protocol.

```bash
176.313.73.104:3128
67.205.290.164:8080
446.21.153.16:1080
...
```

If you consider it important, you can add the parameter `with_proto` to include the protocol information.

```bash
https://api.prxchk.com/v2/proxies.txt?with_proto

http://176.313.73.104:3128
socks4://67.205.290.164:8080
socsk5://446.21.153.16:1080
...
```

The parameters `protocol`, `country` and `port` can combine permissible values by separating them with commas, allowing
you to flexibly manage filtering rules for the list.

```bash
https://api.prxchk.com/v2/proxies.txt?protocol=http,socks5
# or
https://api.prxchk.com/v2/proxies.txt?country=US,DE
# or
https://api.prxchk.com/v2/proxies.txt?port=8080,3128
```

The parameters `country` and `port` can accept inverted values, which are equivalent to the statement "all except." To
achieve this, you need to add an exclamation mark (!) before the parameter value.

```bash
https://api.prxchk.com/v2/proxies.txt?country=!RU,!CN
# or
https://api.prxchk.com/v2/proxies.txt?port=!80,!8888
```

Each of the provided proxies has a very high level of anonymity. However, you may want to receive only those proxies
that do not use rotation under the hood.

```bash
https://api.prxchk.com/v2/proxies.txt?anonimity=elite
```

You have the option to conveniently sort the list of returned proxies based on one of the specified criteria. For any of
the parameters, sorting does not have an explicit ASC or DESC notation. The returned result is always generated from
"**best to worst**".

```bash
https://api.prxchk.com/v2/proxies.txt?order=uptime

176.313.73.104:3128 # 87%
67.205.290.164:8080 # 75%
446.21.153.16:1080 # 34%
...
```

```bash
# represents the number of consecutive successful checks performed
https://api.prxchk.com/v2/proxies.txt?order=stability

176.313.73.104:3128 # 5
67.205.290.164:8080 # 4
446.21.153.16:1080 # 3
...
```

```bash
https://api.prxchk.com/v2/proxies.txt?order=updated_at

176.313.73.104:3128 # 2024-02-01 12:56:46
67.205.290.164:8080 # 2024-02-01 11:34:35
446.21.153.16:1080 # 2024-02-01 10:12:15
...
```

```bash
https://api.prxchk.com/v2/proxies.txt?order=timeout

176.313.73.104:3128 # 0.1 s
67.205.290.164:8080 # 2.3 s
446.21.153.16:1080 # 5 s
...
```

```bash
# each request sets a random order for the list
https://api.prxchk.com/v2/proxies.txt?order=random

67.205.290.164:8080
446.21.153.16:1080
176.313.73.104:3128
77.338.79.191:5678
...
```

## Tips & Tricks

```bash
# the most stable any-type proxy from Germany
curl -H 'AQBA5gEABCDEFDobwmAxV3XTSrDpU7bxaEaeeM2Wg' \
https://api.prxchk.com/v2/proxies.txt?with_proto&order=stability&country=DE&limit=1
```

```bash
# the freshest socks5 proxy not from China
curl -H 'AQBA5gEABCDEFDobwmAxV3XTSrDpU7bxaEaeeM2Wg' \
https://api.prxchk.com/v2/proxies.txt?protocol=socks5&order=updated_at&country=!CN&limit=1
```

```bash
# the fastest http proxy from
curl -H 'AQBA5gEABCDEFDobwmAxV3XTSrDpU7bxaEaeeM2Wg' \
https://api.prxchk.com/v2/proxies.txt?protocol=http&order=timeout&limit=1
```
1 change: 1 addition & 0 deletions MD5SUM
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
e05d1df52ca086ec42e7bbea1163d35a
59 changes: 59 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
# The ULTIMATE List of Top FREE Proxy Servers in 2024 🔥

[![stars](https://img.shields.io/github/stars/prxchk/proxy-list?cacheSeconds=600&style=social)](https://github.com/prxchk/proxy-list/stargazers)
[![last commit](https://img.shields.io/github/last-commit/prxchk/proxy-list/main?cacheSeconds=600)](https://github.com/prxchk/proxy-list/commit/main)
[![total_md5sum](https://img.shields.io/badge/md5sum-e05d1df52ca086ec42e7bbea1163d35a-red)](https://raw.githubusercontent.com/prxchk/proxy-list/main/MD5SUM)
[![total count](https://img.shields.io/badge/total-100-blue)](https://raw.githubusercontent.com/prxchk/proxy-list/main/all.txt)
[![http count](https://img.shields.io/badge/http-58-blue)](https://raw.githubusercontent.com/prxchk/proxy-list/main/http.txt)
[![socks4 count](https://img.shields.io/badge/socks4-32-blue)](https://raw.githubusercontent.com/prxchk/proxy-list/main/socks4.txt)
[![socks5 count](https://img.shields.io/badge/socks5-10-blue)](https://raw.githubusercontent.com/prxchk/proxy-list/main/socks5.txt)

> [!NOTE]
> Your support is incredibly important to us and is a fundamental component of our project's success. Should you have a moment to spare, we cordially invite you to bestow a star upon our project on GitHub. Your endorsement would be an invaluable source of encouragement, spurring us on to further improve and perfect our project. We are deeply grateful for your consideration and extend our heartfelt thanks for being an essential contributor to our journey!
## 😊 Deduplication

We have meticulously eliminated duplicate entries from our proxy list, ensuring a refined and optimized selection.

## ⚔️ Double-verified for reliability

Each proxy on our list has undergone rigorous reliability checks not once, but twice, ensuring the highest level of
dependability and performance.

## 🔐 HTTPS support

Rest assured that every proxy on our list fully supports HTTPS connections, providing a secure and encrypted
communication channel for your peace of mind.

## 🔗 cURL compatibility

Our proxies seamlessly integrate with cURL, the widely acclaimed and versatile command-line tool, empowering you to
effortlessly make HTTP requests with enhanced efficiency and flexibility.

## ⚡ Lightning-fast speeds

Experience lightning-fast browsing speeds with our state-of-the-art proxies, enabling you to enjoy unparalleled
efficiency and seamless web browsing performance.

## 🔍 Sourced from trusted public repositories

Our proxy list is carefully curated from highly reputable public sources, guaranteeing the legitimacy and continuous
availability of each included proxy.

## Quick download

```console
curl -sL https://raw.githubusercontent.com/prxchk/proxy-list/main/all.txt -o all.txt
```

```console
curl -sL https://raw.githubusercontent.com/prxchk/proxy-list/main/http.txt -o http.txt
```

```console
curl -sL https://raw.githubusercontent.com/prxchk/proxy-list/main/socks4.txt -o socks4.txt
```

```console
curl -sL https://raw.githubusercontent.com/prxchk/proxy-list/main/socks5.txt -o socks5.txt
```
1 change: 1 addition & 0 deletions UPDATED
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
2024-04-13 19:40:00
100 changes: 100 additions & 0 deletions all.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
socks4://202.40.177.94:5678
http://102.38.31.8:9999
http://41.159.154.43:3128
http://38.10.90.246:8080
http://103.196.28.6:8080
socks5://173.249.7.118:2276
http://103.230.49.132:8080
socks4://201.184.145.210:5678
http://138.121.142.154:8080
http://101.33.252.195:8081
http://79.174.188.153:8080
socks4://49.229.32.165:4153
http://103.181.168.218:8080
socks5://46.10.229.243:7777
http://200.94.102.148:999
http://88.255.65.120:8080
socks4://45.226.83.146:4153
socks5://163.53.204.178:9813
http://103.255.145.62:84
socks4://109.248.236.150:9898
http://217.197.237.74:8080
http://197.232.47.122:8080
http://102.67.101.250:8080
socks5://51.38.50.249:9224
http://103.122.32.10:8080
socks4://185.89.156.130:5678
http://212.252.66.209:8080
socks4://200.80.227.234:4145
http://103.167.171.43:8080
http://103.177.21.9:8080
socks4://122.248.46.26:4145
http://185.191.236.162:3128
socks4://41.162.162.140:4153
http://103.90.156.220:8080
http://110.74.221.48:8080
http://45.230.49.2:999
http://38.52.221.44:999
socks4://80.58.149.246:4145
socks4://202.51.124.166:1080
http://103.122.66.140:1111
http://202.154.18.133:8080
socks4://164.163.21.14:8291
http://222.70.81.82:9000
http://103.132.52.24:8080
socks4://177.91.76.34:4153
socks5://149.129.135.57:6666
http://185.103.26.78:3128
socks4://190.232.89.125:5678
http://81.12.40.250:8080
http://152.169.106.145:8080
http://45.173.12.141:1994
http://120.28.204.19:80
http://202.12.80.14:83
http://103.165.211.174:3128
http://137.59.50.39:8080
socks4://179.97.193.250:4153
http://103.6.223.2:3128
http://115.74.246.138:8080
http://190.52.165.120:8080
http://103.42.120.43:8080
http://94.131.107.45:3128
http://191.102.254.9:8084
socks4://222.212.85.149:5678
socks5://82.165.198.169:1245
socks4://202.84.76.190:5678
socks4://182.53.96.56:4145
http://183.91.80.194:8089
socks4://94.198.221.222:1080
http://109.201.14.82:8080
http://194.117.230.230:3128
socks5://87.117.11.57:1080
socks4://190.3.72.38:3629
http://103.156.140.239:8080
socks4://63.76.255.180:5678
socks4://176.197.144.158:4153
http://179.108.220.184:8080
socks5://81.21.82.116:1080
http://201.77.108.48:999
http://103.234.254.6:7777
socks5://162.144.103.99:2654
http://222.127.135.164:8082
http://206.62.64.34:8080
http://191.242.126.94:8080
http://190.7.138.78:8080
socks4://110.77.149.50:5678
http://64.157.16.43:8080
http://103.107.84.184:8080
socks4://87.126.141.10:4145
socks4://77.77.26.152:4153
socks4://78.128.95.125:4153
http://113.78.190.20:1111
socks5://46.0.203.140:4890
socks4://212.231.197.29:4145
socks4://203.79.29.198:1080
socks4://103.131.8.27:5678
http://14.143.172.238:8080
socks4://125.27.10.84:4153
socks4://103.164.190.221:5430
socks4://183.88.247.52:4153
http://191.240.153.165:8080
58 changes: 58 additions & 0 deletions http.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
38.52.221.44:999
120.28.204.19:80
103.234.254.6:7777
202.154.18.133:8080
137.59.50.39:8080
38.10.90.246:8080
138.121.142.154:8080
110.74.221.48:8080
191.240.153.165:8080
64.157.16.43:8080
185.103.26.78:3128
103.90.156.220:8080
102.67.101.250:8080
109.201.14.82:8080
102.38.31.8:9999
103.196.28.6:8080
202.12.80.14:83
88.255.65.120:8080
191.102.254.9:8084
115.74.246.138:8080
103.255.145.62:84
185.191.236.162:3128
103.165.211.174:3128
197.232.47.122:8080
103.107.84.184:8080
103.122.66.140:1111
222.70.81.82:9000
113.78.190.20:1111
103.177.21.9:8080
179.108.220.184:8080
81.12.40.250:8080
103.156.140.239:8080
103.230.49.132:8080
14.143.172.238:8080
222.127.135.164:8082
152.169.106.145:8080
101.33.252.195:8081
191.242.126.94:8080
41.159.154.43:3128
79.174.188.153:8080
103.167.171.43:8080
201.77.108.48:999
103.42.120.43:8080
45.173.12.141:1994
194.117.230.230:3128
190.52.165.120:8080
183.91.80.194:8089
206.62.64.34:8080
190.7.138.78:8080
103.6.223.2:3128
103.181.168.218:8080
217.197.237.74:8080
200.94.102.148:999
94.131.107.45:3128
103.122.32.10:8080
212.252.66.209:8080
45.230.49.2:999
103.132.52.24:8080
Loading

0 comments on commit c59e9b4

Please sign in to comment.