Trích xuất qua API (chế độ danh sách trắng)
Ở chế độ danh sách trắng, bạn trích xuất hàng loạt proxy dạng IP:cổng qua request HTTP GET, kết nối trực tiếp mà không cần tài khoản/mật khẩu. Bản thân danh sách trắng cũng hỗ trợ quản lý qua API, cho phép tự động hóa toàn bộ quy trình bằng chương trình.
Điều kiện tiên quyết
- Đã mua gói Proxy Dân Cư.
- IP đầu ra của máy chủ đã được thêm vào danh sách trắng (thao tác tại trang "Danh sách trắng" trong bảng điều khiển, hoặc dùng API quản lý danh sách trắng ở phần dưới trang này).
Endpoint trích xuất
GET https://api.eproxies.net/gateway_api/extract_ip
| Tham số | Bắt buộc | Giá trị hợp lệ | Mô tả |
|---|---|---|---|
count | Có | Số | Số lượng trích xuất mỗi lần |
country | Không | Mã quốc gia / Global | Khu vực, ví dụ US; Global nghĩa là không giới hạn quốc gia |
protocol | Không | http / socks5 | Giao thức proxy |
format | Không | txt / json | Định dạng trả về |
session | Không | sticky / random | Loại IP: sticky cố định (dùng lại cùng một nhóm IP) / random ngẫu nhiên |
separator | Không | crlf / br / cr / lf / tab | Ký tự phân tách của định dạng txt: \r\n, </br>, \r, \n, \t |
st | Không | Chuỗi tùy chỉnh | Ký tự phân tách tùy chỉnh (thay thế cho separator) |
Ví dụ:
# Trích xuất 10 proxy HTTP tại Mỹ, định dạng JSON, IP cố định
curl "https://api.eproxies.net/gateway_api/extract_ip?count=10&country=US&protocol=http&format=json&session=sticky"
# Trích xuất 5 proxy SOCKS5 quốc gia ngẫu nhiên, định dạng txt, mỗi dòng một proxy
curl "https://api.eproxies.net/gateway_api/extract_ip?count=5&protocol=socks5&format=txt&separator=lf&session=random"
Khi format=json, kết quả trả về là mảng đối tượng, mỗi phần tử có hai trường ipAddress và portValue:
[
{ "ipAddress": "203.0.113.10", "portValue": 23333 },
{ "ipAddress": "203.0.113.11", "portValue": 23333 }
]
import requests
resp = requests.get(
"https://api.eproxies.net/gateway_api/extract_ip",
params={"count": 10, "country": "US", "protocol": "http",
"format": "json", "session": "sticky"},
timeout=30,
)
proxy_list = resp.json()
# Proxy trích xuất được dùng bằng kết nối trực tiếp, không cần tài khoản/mật khẩu
first = proxy_list[0]
endpoint = f"{first['ipAddress']}:{first['portValue']}"
proxies = {"http": f"http://{endpoint}", "https": f"http://{endpoint}"}
print(requests.get("https://ipinfo.io", proxies=proxies, timeout=30).json())
Danh sách quốc gia hỗ trợ trích xuất (trả về country mã quốc gia, name tên, flag_url biểu tượng quốc kỳ):
GET https://api.eproxies.net/gateway_api/country-list
Request trích xuất bắt buộc phải được gửi từ IP nằm trong danh sách trắng, nếu không sẽ bị từ chối. Trang "Trích xuất API" trong bảng điều khiển có sẵn trình tạo link trực quan.
API quản lý danh sách trắng
Việc thêm, xóa, tra cứu danh sách trắng đều thực hiện được hoàn toàn qua API — thuận tiện cho việc tự động bảo trì khi IP đầu ra thay đổi. Cả ba endpoint đều xác thực bằng userName (tên người dùng) + userKeyValue (khóa người dùng, lấy trong bảng điều khiển):
# Thêm IP vào danh sách trắng
curl "https://api.eproxies.net/gateway_api/add-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10"
# Xóa IP khỏi danh sách trắng
curl "https://api.eproxies.net/gateway_api/del-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10"
# Tra cứu danh sách trắng hiện tại
curl "https://api.eproxies.net/gateway_api/lists-ip?userName=USERNAME&userKeyValue=USER_KEY"
Quy trình tự động hóa điển hình (môi trường có IP đầu ra không cố định):
import requests
BASE = "https://api.eproxies.net/gateway_api"
AUTH = {"userName": "USERNAME", "userKeyValue": "USER_KEY"}
# 1. Lấy IP đầu ra hiện tại của máy
my_ip = requests.get("https://ipinfo.io/json", timeout=30).json()["ip"]
# 2. Thêm IP đó vào danh sách trắng
requests.get(f"{BASE}/add-ip", params={**AUTH, "ipAddress": my_ip}, timeout=30)
# 3. Trích xuất proxy và sử dụng
proxies = requests.get(
f"{BASE}/extract_ip",
params={"count": 10, "country": "US", "protocol": "http",
"format": "json", "session": "random"},
timeout=30,
).json()
print(proxies)
Chọn chế độ tài khoản + mật khẩu hay chế độ trích xuất
| Chế độ tài khoản + mật khẩu | Trích xuất qua API (danh sách trắng) | |
|---|---|---|
| Độ chi tiết định vị | Quốc gia/bang/thành phố/ASN | Quốc gia |
| Kiểm soát phiên | Điều khiển chi tiết bằng sid/ttl | session=sticky/random theo từng đợt |
| Khả năng áp dụng | Phần mềm cần hỗ trợ xác thực proxy | Mọi phần mềm hỗ trợ proxy |
| Kịch bản khuyến nghị | Tích hợp code, thu thập dữ liệu tinh chỉnh | Công cụ cũ, phân phối hàng loạt, môi trường không xác thực |
Đặc tả OpenAPI
Định nghĩa máy đọc được của mọi endpoint trên trang này có tại openapi.json — nhập vào Postman / Swagger UI hoặc tải từ AI agent.
