一、为什么选择API方式提取代理

API方式提取代理IP相比手动复制粘贴或静态文件下载，具有以下核心优势：

• 实时性：每次请求返回当前池中最新验证通过的代理，而非过期静态列表
• 自动化：可直接集成到脚本或程序中，无需人工干预
• 灵活筛选：通过参数可以精确筛选协议、匿名度、网关可用性等
• 多格式支持：JSON适合程序解析，TXT适合简单脚本，CSV适合数据分析

二、核心API参数详解

以 的API接口 为例，完整的提取示例如下：

GET /api.php?key=YOUR_KEY&count=10&protocol=http&anonymity=elite&gw=yy&sort=speed&order=asc&format=json

核心参数说明

• key：你的专属API KEY（注册后获得），必填参数
• count：提取数量，默认10条。免费用户有上限，付费用户不限制
• protocol：协议筛选（http / https / socks4 / socks5）
• anonymity：匿名度筛选（elite=高匿 / anonymous=匿名 / transparent=透明）
• gw：网关筛选，指定通过某网关验证的代理。多选用逗号分隔，如 gw=yy,tx。配合 gw_mode=all|any 控制多网关的匹配逻辑
• sort：排序方式（random=随机 / speed=速度 / score=评分 / last_check=最近验证时间）
• format：返回格式（json / txt / txtp / csv）

三、不同编程语言的调用示例

PHP 调用示例

$apiUrl = '/api.php?key=YOUR_KEY&count=5&format=json';
$response = file_get_contents($apiUrl);
$proxies = json_decode($response, true);
foreach ($proxies['data'] as $p) {
    echo "{$p['ip']}:{$p['port']} ({$p['protocol']})\n";
}

Python 调用示例

import requests
import random

API_URL = "/api.php"
params = {
    "key": "YOUR_KEY",
    "count": 10,
    "anonymity": "elite",
    "sort": "random",
    "format": "json"
}
resp = requests.get(API_URL, params=params)
proxies = resp.json()["data"]

# 随机选择一个代理进行请求
proxy = random.choice(proxies)
proxy_url = f"{proxy['protocol']}://{proxy['ip']}:{proxy['port']}"
r = requests.get("https://target-site.com", proxies={"http": proxy_url, "https": proxy_url}, timeout=10)

cURL 命令行调用

# JSON格式提取
curl "/api.php?key=YOUR_KEY&count=5&format=json"

# 文本格式（每行 ip:port），适合直接传给其他工具
curl "/api.php?key=YOUR_KEY&count=5&format=txt"

四、多种返回格式的适用场景

格式	参数	示例输出	适用场景
JSON	format=json	完整结构化数据	程序集成首选
TXT	format=txt	ip:port 每行一条	Shell脚本、简单工具
TXTP	format=txtp	protocol://ip:port	需要协议前缀的工具
CSV	format=csv	带表头的CSV	Excel分析、数据导入

五、自动化集成方案

方案一：定时拉取 + 本地缓存

1. 设置 cron 定时任务（如每5分钟执行）
2. 调用API获取最新代理列表
3. 存储到本地文件或内存缓存
4. 采集程序从本地缓存读取代理，减少API调用频率

方案二：按需拉取 + 代理轮换

1. 采集程序启动时调用API获取一批代理（如20个）
2. 在采集循环中随机选择代理使用
3. 当这批代理用尽或失败率过高时，重新调用API获取新批次

方案三：事件驱动 + 智能替换

1. 维持一个活跃代理列表
2. 监听代理失败事件（超时、403、连接重置等）
3. 代理失败时从列表中移除，并触发API请求补充新代理
4. 保持活跃代理数量始终在预设范围内

六、API调用的注意事项

• 保护好你的API KEY：不要将KEY硬编码在公开的代码仓库中，使用环境变量或配置文件管理
• 注意频率限制：了解API的调用频率限制，避免频繁请求导致被限流
• 做好错误处理：API可能返回错误（网络问题、KEY无效、额度用尽等），需要妥善处理
• 使用HTTPS：确保API请求通过HTTPS进行，防止中间人攻击窃取KEY
• 参数URL编码：参数值如包含特殊字符，需要进行URL编码
• JSONP支持：如果在前端JavaScript中调用，可以使用 callback 参数获取JSONP格式

七、总结

通过API接口提取代理IP是实现代理自动化的最佳方式。主要优势在于：

• 实时获取经过验证的高质量代理，免去手动筛选的繁琐
• 灵活的参数筛选和多种返回格式，适应不同技术栈
• 支持代理轮换和自动化集成，可与各种采集框架无缝对接
• 网关验证功能确保代理在特定业务场景下真正可用

建议从免费套餐开始体验，确认API满足需求后再决定是否升级付费套餐。完整的API文档见 /api.html。