首页 > API 文档 > 提取接口

提取接口（GetIP）

提取接口是使用频率最高的一个接口：一次调用按你指定的数量、城市、运营商返回可用的代理 IP。请求方式：HTTP GET，返回纯文本或 JSON。接口地址：http://api.xydaili.net:2022/tools/ip.ashx

请求参数

参数是否必填默认值说明
action否GetIP不传或传 GetIP 都是提取 IP；其他取值见 其他接口 与 白名单接口
OrderNumber是—订单号（32 位），会员中心「我的订单」里查看，等同凭证，请勿泄露
qty否1本次提取数量。建议一次取 5~20 条，减少接口调用；超过单次上限会返回 506
protocol否1协议类型，1=HTTP（同时支持 HTTPS 目标站点），线路支持 SOCKS5 时按线路说明填写
Area否空指定城市，如 南京；留空表示不限地区。一次只能指定一个城市
Isp否空指定运营商，如 电信、联通、移动
poolIndex否0多线路账号用于选择第几条线路池，单线路保持 0
dt否0线路特定参数（例如去重模式开关），不同线路含义不同；直接用在线提取页生成的链接即可
Cache否-1设为 1 时开启缓存复用：在缓存窗口内重复调用会拿到同一批 IP，适合需要固定出口的连续请求
Cachetimems否0缓存窗口毫秒数，配合 Cache=1 使用，例如 60000 表示一分钟内复用同一批 IP
bufferTime否0只返回剩余有效期大于该秒数的 IP，例如 60 可避免拿到即将失效的 IP
endTime否不限制只返回剩余有效期不超过该秒数的 IP，用于控制轮换节奏
split否换行返回格式：json 返回结构化 JSON；也可填 \n、\r、\r\n、\t 指定文本分隔符

返回格式

文本模式（split 留空或指定分隔符）

113.75.1.20:51008
112.84.36.17:42913

每行一条，格式为 IP:端口；使用账号密码模式的线路为 IP:端口:用户名:密码。把这一串直接填进爬虫的代理配置即可。

JSON 模式（split=json）

{
  "status": 200,
  "msg": "成功",
  "QTY": 1,
  "leftTime": "1天02小时",
  "leftIp": "998(剩余量)",
  "data": [
    {
      "ip": "113.75.1.20",
      "port": "51008",
      "city": "南京",
      "isp": "电信",
      "expire": "2026-09-26T09:39:53",
      "outip": "",
      "userName": "",
      "pwd": ""
    }
  ]
}
字段说明
status200 表示成功，其他值见 状态码对照表
msg提示信息，失败时通常包含具体原因
QTY本次返回的 IP 条数，可为 0
leftIp套餐剩余量或已用量（按套餐类型不同而不同）
leftTime订单剩余有效期
data[].ip / port代理地址与端口
data[].city / isp该 IP 的归属城市与运营商
data[].expire该 IP 的失效时间，可据此提前换 IP
data[].outip实际出口 IP（用于核对白名单或排查链路）
data[].userName / pwd账号密码模式的凭据，IP 授权模式为空

常用示例

1. 提取一条（最简）

http://api.xydaili.net:2022/tools/ip.ashx?action=GetIP&OrderNumber=你的订单号&qty=1

2. 批量提取 20 条

http://api.xydaili.net:2022/tools/ip.ashx?action=GetIP&OrderNumber=你的订单号&qty=20

3. 指定城市 + 运营商

http://api.xydaili.net:2022/tools/ip.ashx?action=GetIP&OrderNumber=你的订单号&qty=5&Area=南京&Isp=电信

4. 拿结构化数据（带剩余有效期与剩余量）

http://api.xydaili.net:2022/tools/ip.ashx?action=GetIP&OrderNumber=你的订单号&qty=5&split=json

5. 一分钟内复用同一批 IP（需要固定出口）

http://api.xydaili.net:2022/tools/ip.ashx?action=GetIP&OrderNumber=你的订单号&qty=3&Cache=1&Cachetimems=60000

6. 只取剩余有效期 60 秒以上的 IP

http://api.xydaili.net:2022/tools/ip.ashx?action=GetIP&OrderNumber=你的订单号&qty=10&bufferTime=60

注意事项

  • 接口是 HTTP 协议（http://api.xydaili.net:2022），不要写成 https，也不要带证书校验。
  • 接口有频率限制：单条循环提取很容易触发 406 提取频率过快，建议改成批量提取 + 本地小池子补货。
  • 返回里可能出现 QTY=0：表示本次没有可用 IP（该城市暂无资源或正在轮换），建议换城市或稍后重试，不要短时间连续打接口。
  • 无效请求会被"慢返回"：订单号不存在、订单已过期或参数错误时，接口会延迟约 15 秒返回错误，并临时限制来源 IP（防刷设计）。不要把这类错误当成可重试异常去循环调用，应记录并告警。
  • 订单号即凭证，请放在服务端配置里，不要写进前端页面或公开仓库。
  • 指定城市时请填写城市名（如 南京）；覆盖范围以你账号线路为准，可在 在线提取 页查看可选城市。

相关文档

打开在线提取页试用

在线提取页可以可视化选城市、数量，并直接生成上面这些链接。