Bảng điều khiển

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

  1. Đã mua gói Proxy Dân Cư.
  2. 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ộcGiá trị hợp lệMô tả
countSốSố lượng trích xuất mỗi lần
countryKhôngMã quốc gia / GlobalKhu vực, ví dụ US; Global nghĩa là không giới hạn quốc gia
protocolKhônghttp / socks5Giao thức proxy
formatKhôngtxt / jsonĐịnh dạng trả về
sessionKhôngsticky / randomLoại IP: sticky cố định (dùng lại cùng một nhóm IP) / random ngẫu nhiên
separatorKhôngcrlf / br / cr / lf / tabKý tự phân tách của định dạng txt: \r\n, </br>, \r, \n, \t
stKhôngChuỗi tùy chỉnhKý 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 ipAddressportValue:

[
  { "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ẩuTrích xuất qua API (danh sách trắng)
Độ chi tiết định vịQuốc gia/bang/thành phố/ASNQuốc gia
Kiểm soát phiênĐiều khiển chi tiết bằng sid/ttlsession=sticky/random theo từng đợt
Khả năng áp dụngPhần mềm cần hỗ trợ xác thực proxyMọ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ỉnhCô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.