API proxy miễn phí
GET /api/free-proxy trả về các quan sát proxy miễn phí công khai hiện tại của Litport. Không cần xác thực.
Yêu cầu#
curl --get 'https://litport.net/api/free-proxy' \
--data-urlencode 'country=de' \
--data-urlencode 'protocol=http' \
--data-urlencode 'uptimeRating=90' \
--data-urlencode 'sortBy=responseTimeMs_asc' \
--data-urlencode 'limit=50'
| Tham số | Kiểu | Mặc định | Hành vi hiện tại |
|---|---|---|---|
country |
string | all | Mã ISO-2 không phân biệt chữ hoa chữ thường. Giá trị được chuyển thành chữ hoa; không áp dụng bí danh nào. |
limit |
integer | 50 | Phạm vi chấp nhận 10–1000. Giá trị không hợp lệ hoặc ngoài phạm vi bị bỏ qua. |
page |
integer | 1 | Phạm vi chấp nhận 1–1000. Giá trị không hợp lệ hoặc ngoài phạm vi bị bỏ qua. |
sortBy |
string | pingAt_desc | Trường: pingAt, response |
anonymity |
string | all | Bộ lọc khớp chính xác: transparent, anonymous, elite hoặc unknown. Giá trị không xác định thường trả về mảng rỗng. |
anonymity |
string | all | Bí danh đã lỗi thời: high = anonymous hoặc elite, low = transparent. Bộ lọc khớp chính xác. Giá trị không xác định thường trả về mảng rỗng. |
protocol |
string | all | Bộ lọc khớp chính xác như http, https hoặc socks5. Giá trị không xác định thường trả về mảng rỗng. |
list |
string | all | Cấu hình sẵn có tên cho danh sách được tạo: https (hỗ trợ HTTPS), fast (độ trễ làm tròn dưới 1000 ms), stable (thời gian hoạt động bảy ngày làm tròn tối thiểu 90% với tối thiểu 50 lần kiểm tra) hoặc anonymous (anonymous hoặc elite). Giá trị không xác định bị bỏ qua. |
uptimeRating |
integer | không có | Tỷ lệ thời gian hoạt động 24 giờ tối thiểu, 1–100. Giá trị không hợp lệ bị bỏ qua. |
response |
integer | không có | Thời gian phản hồi HTTP tối đa tính bằng mili giây, 1–10000. Giá trị không hợp lệ bị bỏ qua. |
checked |
integer | không có | Tuổi tối đa của pingAt tính bằng phút, 1–1440. Snapshot mặc định là 30; bộ lọc độ mới này loại các dấu thời gian muộn hơn thời điểm yêu cầu. |
format |
string | json | json, csv, txt hoặc txt-proto. Giá trị không xác định sẽ dùng JSON. |
download |
flag | tắt | Khi có mặt ở định dạng được hỗ trợ, trả về tệp đính kèm. |
country dùng mã ISO-2, không phân biệt hoa thường, và được chuyển thành chữ hoa khi tra cứu. Không có bảng bí danh: dùng country=gb; country=uk có thể trả về mảng rỗng. Tên người dùng proxy PPG có cách xử lý tương thích khác.
Hành vi của phản hồi#
Phản hồi JSON mặc định là một mảng trần, không có lớp bọc data, không có tổng số hay giá trị hasMore. Phân trang không cho biết tổng số: độ lệch trang là (page - 1) * limit, và mảng rỗng nghĩa là không có dòng nào khớp ở trang đó.
Tập dữ liệu gốc có thể cũ tới 120 giây, và phản hồi gửi Cache-Control: public, max-age=60 cộng thêm vào đó, nên phản hồi có thể chậm hơn lần kiểm tra gần nhất tới khoảng 3 phút; thăm dò nhanh hơn thời gian lưu đệm sẽ trả về cùng các dòng. Trong phiên bản này, tham số số không hợp lệ và giá trị sortBy không hợp lệ bị bỏ qua mà không báo lỗi, giữ giá trị mặc định. Giá trị bộ lọc khớp chính xác không xác định thường cho ra mảng rỗng thay vì phản hồi 400.
checkedWithinMin chỉ giữ các proxy được kiểm tra trong khoảng 1–1440 phút được yêu cầu. Nó loại các dấu thời gian muộn hơn thời điểm yêu cầu. Để tương thích, endpoint phân trang không có bộ lọc độ mới mặc định.
[
{
"protocol": "http",
"host": "192.0.2.10",
"port": 8080,
"externalIp": "192.0.2.10",
"geoCountry": "US",
"https": true,
"anonymity": "elite",
"anonymityRating": 100,
"responseTimeMs": 420,
"uptimeRating": 97,
"pingAt": "2026-08-25T12:00:00.000Z"
}
]
Các địa chỉ ví dụ trong tài liệu này được dành riêng cho tài liệu và không phải proxy đang hoạt động.
Trường JSON#
| Trường | Kiểu | Ý nghĩa |
|---|---|---|
protocol |
string | Giao thức proxy. |
host |
string | Tên host hoặc địa chỉ IP của proxy. |
port |
integer | Cổng proxy. |
externalIp |
string | IP đầu ra đã quan sát. |
geoCountry |
string | Quốc gia đầu ra theo ISO-2. |
geo |
string | Cờ quốc gia để hiển thị. |
geoRegion |
string | Vùng đầu ra đã quan sát. |
geoCity |
string | Thành phố đầu ra đã quan sát. |
geoTimezone |
string | Múi giờ đầu ra đã quan sát. |
asn |
integer or string | Số hệ thống tự trị đã quan sát; các quan sát cũ có thể dùng chuỗi có tiền tố AS. |
asnOrgName |
string | Tổ chức mạng đã quan sát. |
https |
boolean | true khi một yêu cầu HTTPS đi qua proxy bằng đường hầm với chứng chỉ hợp lệ; null khi chưa đo. |
anonymity |
string | Phân loại ẩn danh đã đo: transparent, anonymous, elite hoặc unknown. |
anonymity |
integer | Điểm ẩn danh đã chuẩn hóa. |
anonymity |
string | Bí danh đã lỗi thời: high = anonymous hoặc elite, low = transparent. |
anonymity |
integer | Bí danh đã lỗi thời, bằng anonymity |
response |
number | Thời gian phản hồi HTTP đã đo tính bằng mili giây. |
response |
integer | Điểm thời gian phản hồi đã chuẩn hóa. |
uptimeRating |
integer | Tỷ lệ thời gian hoạt động 24 giờ đã làm tròn. |
uptime7d |
number | Tỷ lệ thời gian hoạt động bảy ngày, làm tròn đến một chữ số thập phân. |
checks7d |
integer | Số lần kiểm tra góp vào giá trị thời gian hoạt động bảy ngày. |
uptime24h |
number | Tỷ lệ thời gian hoạt động 24 giờ, làm tròn đến một chữ số thập phân. |
checks24h |
integer | Số lần kiểm tra góp vào giá trị thời gian hoạt động 24 giờ. |
sourcesCount |
integer | Số danh sách nguồn đã quan sát chứa proxy này. |
response |
number | Độ trễ trung vị trượt trên các lần kiểm tra hoạt động gần đây, có thể là số thập phân, hoặc null khi không có. |
lastAliveAt |
date-time | Lần gần nhất proxy này vượt qua kiểm tra hoạt động. |
createdAt |
date-time | Lần đầu Litport quan sát proxy này. |
pingAt |
date-time | Lần cuối Litport kiểm tra proxy này. |
createdAt ghi lại thời điểm Litport quan sát proxy lần đầu. pingAt ghi lại lần kiểm tra gần nhất và là tín hiệu độ mới đáng dùng. https cho biết một yêu cầu HTTPS qua proxy có hoàn tất với chứng chỉ hợp lệ, đáng tin cậy hay không; giá trị là null cho đến khi được đo. anonymity cho biết proxy để lộ bao nhiêu về chính nó và người gọi (transparent, anonymous, elite hoặc unknown); anonymityLevel là bí danh hai giá trị đã lỗi thời, giữ lại để tương thích.
Ảnh chụp nhất quán#
GET /api/free-proxy/snapshot trả về một thế hệ dữ liệu hoàn chỉnh, được lọc nhất quán. Mặc định là checkedWithinMin=30, nhận các bộ lọc giống endpoint danh sách trừ page, limit, sortBy, format và download, và trả về tối đa 20,000 dòng sắp xếp theo độ mới. Giá trị checkedWithinMin không hợp lệ trả về 400.
{
"generatedAt": "2026-09-09T22:40:12.000Z",
"count": 2121,
"totalCount": 2121,
"truncated": false,
"maxAgeMin": 30,
"proxies": []
}
Cả hai endpoint đều cung cấp ETag và Last-Modified cho yêu cầu có điều kiện. Gửi ETag đã nhận trong If-None-Match; yêu cầu khớp và hợp lệ chỉ nhận 304 Not Modified sau khi phản hồi đã lọc hiện tại của nó được tính xong.
Định dạng CSV và văn bản#
# CSV
curl 'https://litport.net/api/free-proxy?format=csv&limit=25'
# host:port, one proxy per line
curl 'https://litport.net/api/free-proxy?format=txt&limit=25'
# protocol://host:port, one proxy per line
curl 'https://litport.net/api/free-proxy?format=txt-proto&limit=25'
Dùng download=1 với một định dạng được hỗ trợ để yêu cầu tệp đính kèm. CSV được trả về dưới dạng text/csv; các biến thể văn bản dùng text/plain; JSON dùng application/json.
Ví dụ JavaScript#
const url = new URL('https://litport.net/api/free-proxy')
url.searchParams.set('country', 'us')
url.searchParams.set('limit', '25')
const response = await fetch(url)
if (!response.ok) throw new Error(`HTTP ${response.status}`)
const proxies = await response.json()
Ví dụ Python#
import json
import urllib.parse
import urllib.request
query = urllib.parse.urlencode({"country": "us", "limit": 25})
with urllib.request.urlopen(f"https://litport.net/api/free-proxy?{query}") as response:
proxies = json.load(response)
Tài nguyên cho nhà phát triển#
Xem danh sách proxy miễn phí để kiểm tra dữ liệu hiện tại, lọc ngay trong trình duyệt và sao chép URL yêu cầu để tự thử nghiệm.
Dùng nguồn danh sách proxy miễn phí để hiểu tập dữ liệu được công bố, hoặc xem nguồn SDK proxy miễn phí khi tích hợp API vào ứng dụng.
SDK#
Chọn một client cho môi trường chạy của bạn. Mỗi client lấy và lọc các bản ghi proxy; ứng dụng của bạn quyết định cách dùng chúng.
| Môi trường chạy | Cài đặt | Gói và tài liệu tham khảo |
|---|---|---|
| JavaScript / TypeScript | npm install @litportnet |
gói npm |
| JavaScript / TypeScript qua JSR | npx jsr add @litportnet |
gói JSR và tài liệu tham khảo API |
| C# / .NET | dotnet add package Litportnet |
gói .NET |
| PHP | composer require litportnet |
gói PHP |
| Ruby | gem install litportnet-free-proxy-sdk |
gói Ruby |
| Python | pip install litportnet-free-proxy-sdk |
gói PyPI |
| Go | go get github |
gói Go và tài liệu tham khảo |
| Rust | cargo add litportnet-free-proxy-sdk |
crate Rust · tài liệu tham khảo API |
| Perl | cpanm Web |
bản phân phối CPAN và tài liệu tham khảo |
| Elixir | {: trong mix.exs |
gói Hex · tài liệu tham khảo HexDocs |
| Dart | dart pub add litportnet |
gói pub.dev |
| R | install |
gói R-universe |
Công cụ API#
Bộ sưu tập Postman có sẵn các yêu cầu chạy ngay cho bộ lọc, ảnh chụp, xuất CSV và văn bản. Không cần API key.
Dùng image Docker CLI để xuất bản ghi mà không cần cài môi trường chạy ngôn ngữ cục bộ:
docker run --rm litportnet/free-proxy-sdk:0.1.0 --protocol socks5 --limit 20 --format json
Container lấy các bản ghi proxy; nó không vận hành máy chủ proxy.
Kết nối một AI agent bằng máy chủ MCP, được phát hành dưới tên @litportnet/free-proxy-mcp và có trong MCP Registry chính thức dưới tên io.github.litportnet/free-proxy-mcp. Thêm nó vào bất kỳ client nào tương thích MCP:
{
"mcpServers": {
"free-proxy": {
"command": "npx",
"args": ["-y", "@litportnet/free-proxy-mcp"]
}
}
}
Nó cung cấp ba công cụ chỉ đọc: liệt kê proxy theo bộ lọc, chọn proxy xếp hạng cao nhất và tóm tắt ảnh chụp hiện tại. Như mọi client ở trên, nó trả về bản ghi proxy và không định tuyến lưu lượng.
Tập dữ liệu lịch sử#
Để phân tích phân bố giao thức, quốc gia và độ trễ, tải các quan sát có ghi ngày từ Hugging Face Datasets hoặc Kaggle. Đây là các ảnh chụp cố định có ghi nguồn gốc dữ liệu và giấy phép CC0. Hãy kiểm tra ngày quan sát; dùng API ở trên để lấy bản ghi hiện tại.
Notebook phân tích trên Kaggle đọc ảnh chụp và vẽ biểu đồ phân bố quốc gia, giao thức và độ trễ. Bạn có thể chạy nó mà không cần gọi API trực tiếp.