API提取

API 提取是一种通过接口动态提取代理 IP 的方式，适用于自动化系统、爬虫程序以及需要批量管理代理的开发者场景。

相比用户名 & 密码认证，API 方式更加灵活，可以按需获取代理并自动集成到你的业务流程中。

---

一、什么是 API 获取？

API 提取是指：

👉 通过调用接口链接，自动提取一批代理 IP（IP + Port）

返回的数据通常为 JSON 或文本格式，可直接用于程序调用。

例如返回结果：

{
  "code": 0,
  "success": true,
  "data": [
    {"ip": "1.1.2.2", "port": 14566},
    {"ip": "1.1.2.2", "port": 14577}
  ]
}

---

二、使用前准备

在使用 API 获取代理之前，请确保：

1. 已注册并登录 IPWO 账号

2. 已完成实名认证

3. 已购买或领取动态住宅代理资源

4. 已添加 IP 白名单（必须）

👉 API 调用通常需要绑定白名单 IP，否则无法访问

---

四、获取 API 链接

动态住宅代理/不限量带宽代理

1. 登录 IPWO 用户中心进入对应的代理产品页面

2. 点击「代理使用」

3. 选择「API 提取」

4. 设置参数：

   • 代理数量

   • 国家 / 地区

   • 协议类型（不限量带宽代理默认支持HTTP/HTTPS/SOCKS5协议）

1. 点击「生成代理」

---

五、API 参数说明（常用）

你可以通过 API 参数控制代理行为，例如：

国家 / 地区

zone_JP（日本）
zone_US（美国）

---

州 / 城市

st_California
city_Jackson

---

粘性会话（固定 IP）

sid_123456

👉 用于在一定时间内保持同一 IP

---

IP 存活时间

time_20（20分钟）

👉 与 sid 配合使用，控制 IP 持续时间（最高 180 分钟） (ipwo.net)

---

六、使用建议

• API 适合自动化项目（如爬虫、数据采集）

• 建议按需获取 IP，避免资源浪费

• 合理设置参数（地区 / session / time）提升成功率

• 高并发场景建议结合线程池或队列管理

---

七、常见问题

为什么 API 无法访问？

请确认当前 IP 已加入白名单。

---

API 返回为空怎么办？

请检查：

• 是否有可用流量

• 参数是否设置正确

---

是否可以获取固定 IP？

可以，通过 sid 参数实现粘性会话。

---

九、下一步

完成 API 获取后，你可以继续：

• 查看「参数说明」 → 深入了解参数控制

• 查看「轮换 IP / 粘性 IP」 → 优化 IP 使用策略

• 参考「集成教程」 → 接入你的程序或工具

---

总结

API 获取的核心优势在于“自动化”：

• 动态获取代理 IP

• 灵活控制参数

• 轻松集成到程序中

如果你正在构建自动化系统或爬虫，这是最推荐的代理获取方式。

---