Menu tài liệu

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, responseTimeMs hoặc createdAt. Hướng: asc hoặc desc. Giá trị không hợp lệ bị bỏ qua.
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.
anonymityLevel 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.
responseTimeMs 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.
checkedWithinMin 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.
geoCountryFlagEmoji 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.
anonymityRating integer Điểm ẩn danh đã chuẩn hóa.
anonymityLevel string Bí danh đã lỗi thời: high = anonymous hoặc elite, low = transparent.
anonymityLevelRating integer Bí danh đã lỗi thời, bằng anonymityRating.
responseTimeMs number Thời gian phản hồi HTTP đã đo tính bằng mili giây.
responseTimeRating 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.
responseTimeMedianMs 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/free-proxy-sdk gói npm
JavaScript / TypeScript qua JSR npx jsr add @litportnet/free-proxy-sdk gói JSR và tài liệu tham khảo API
C# / .NET dotnet add package Litportnet.FreeProxy gói .NET
PHP composer require litportnet/free-proxy-sdk 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.com/litportnet/free-proxy-sdk/packages/go 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 WebService::Litportnet::FreeProxy bản phân phối CPAN và tài liệu tham khảo
Elixir {:litportnet_free_proxy, "~> 0.1"} trong mix.exs gói Hex · tài liệu tham khảo HexDocs
Dart dart pub add litportnet_free_proxy gói pub.dev
R install.packages("litportFreeProxy", repos = c("https://litportnet.r-universe.dev", "https://cloud.r-project.org")) 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.