EProxiesEProxies/ 文档
控制台

API 提取(白名单模式)

白名单模式下,通过 HTTP GET 请求批量提取 IP:端口 形式的代理,直连使用、无需账密。白名单本身也支持 API 管理,可实现全流程程序化。

前置条件

  1. 已购买动态住宅代理套餐。
  2. 你服务器的出口 IP 已加入白名单(控制台「白名单」页操作,或用下方白名单管理 API)。

提取接口

GET https://api.eproxies.net/gateway_api/extract_ip
参数必填可选值说明
count是数字单次提取数量
country否国家码 / Global地区,如 US;Global 不限国家
protocol否http / socks5代理协议
format否txt / json返回格式
session否sticky / randomIP 类型:sticky 粘性(复用同一批 IP)/ random 随机
separator否crlf / br / cr / lf / tabtxt 格式的分隔符:\r\n、</br>、\r、\n、\t
st否自定义字符串自定义分隔符(替代 separator)

示例:

# 提取 10 个美国 HTTP 代理,JSON 格式,粘性 IP
curl "https://api.eproxies.net/gateway_api/extract_ip?count=10&country=US&protocol=http&format=json&session=sticky"

# 提取 5 个随机国家 SOCKS5 代理,txt 格式,每行一个
curl "https://api.eproxies.net/gateway_api/extract_ip?count=5&protocol=socks5&format=txt&separator=lf&session=random"

format=json 时返回对象数组,每项含 ipAddress 和 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()

# 提取到的代理直连使用,无需账密
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())

支持提取的国家列表(返回 country 国家码、name 名称、flag_url 国旗图标):

GET https://api.eproxies.net/gateway_api/country-list

提取请求必须从白名单中的 IP 发起,否则会被拒绝。控制台「API 提取」页提供可视化链接生成器。

白名单管理 API

白名单的增删查支持纯 API 操作,便于在出口 IP 变化时自动维护。三个接口都用 userName(用户名)+ userKeyValue(用户密钥,控制台获取)认证:

# 添加白名单 IP
curl "https://api.eproxies.net/gateway_api/add-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10"

# 删除白名单 IP
curl "https://api.eproxies.net/gateway_api/del-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10"

# 查询当前白名单列表
curl "https://api.eproxies.net/gateway_api/lists-ip?userName=USERNAME&userKeyValue=USER_KEY"

典型自动化流程(出口 IP 不固定的环境):

import requests

BASE = "https://api.eproxies.net/gateway_api"
AUTH = {"userName": "USERNAME", "userKeyValue": "USER_KEY"}

# 1. 获取本机当前出口 IP
my_ip = requests.get("https://ipinfo.io/json", timeout=30).json()["ip"]

# 2. 将其加入白名单
requests.get(f"{BASE}/add-ip", params={**AUTH, "ipAddress": my_ip}, timeout=30)

# 3. 提取代理并使用
proxies = requests.get(
    f"{BASE}/extract_ip",
    params={"count": 10, "country": "US", "protocol": "http",
            "format": "json", "session": "random"},
    timeout=30,
).json()
print(proxies)

账密模式与提取模式怎么选

账密模式API 提取(白名单)
定位粒度国家/州/城市/ASN国家
会话控制sid/ttl 精细控制session=sticky/random 按批次
适用性需软件支持代理认证任何支持代理的软件
推荐场景代码集成、精细化采集老旧工具、批量分发、免认证环境

OpenAPI 规范

本页全部接口的机器可读定义见 openapi.json,可直接导入 Postman / Swagger UI,或供 AI Agent 加载调用。