IP提取接口文档
高效稳定的代理IP提取API，支持多种协议和地区选择
接口地址
GET
http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI
提取接口一次调用按你指定的数量、城市、运营商返回可用的代理 IP。请求必须带 action（GetAPI 或 GetIP）和 OrderNumber；默认返回文本，加 split=json 返回结构化 JSON。
请求参数说明
| 参数名称 | 含义 | 是否必填 | 取值范围 |
|---|---|---|---|
action |
接口动作 | 否 | 不传或 GetIP 都是提取 IP；在线提取页生成的链接用 GetAPI |
OrderNumber |
订单号 | 是 | 32 位订单号，会员中心「我的订单」里复制，等同凭证请勿泄露 |
qty |
提取数量 | 否 | 1-200，默认 1；建议一次取 5~20 条，超上限返回 202/506 |
protocol |
协议类型 | 否 | 1: HTTP/HTTPS（默认） 3: SOCKS5 |
Area |
指定城市 | 否 | 如 南京；留空表示不限地区，一次只能指定一个城市 |
Isp |
指定运营商 | 否 | 如 电信、联通、移动 |
ips |
运营商筛选（本地池） | 否 | 0: 不限（默认） 1: 电信 2: 联通 3: 移动 不额外调用上游、响应更快 |
poolIndex |
线路池序号 | 否 | 0: 优质A池（默认） 1: 优质B池 2: 优质C池 单线路账号保持 0 |
dt |
线路参数 | 否 | 线路特定（如去重模式开关），直接用在线提取页生成的链接即可 |
split |
返回格式 / 分隔符 | 否 | json: 结构化 JSON\n、\r、\r\n、\t: 文本分隔符 |
Cache |
缓存复用 | 否 | 设为 1 开启：缓存窗口内重复调用返回同一批 IP，适合需要固定出口的连续请求 |
Cachetimems |
缓存窗口 | 否 | 毫秒，配合 Cache=1，如 60000 表示一分钟内复用同一批 IP |
bufferTime |
最短剩余有效期 | 否 | 秒，只返回剩余有效期大于该值的 IP，如 60 可避免拿到即将失效的 IP |
endTime |
最长剩余有效期 | 否 | 秒，只返回剩余有效期不超过该值的 IP，用于控制轮换节奏 |
请求示例
http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI&OrderNumber=你的订单号&qty=10&protocol=1
http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI&OrderNumber=你的订单号&qty=5&Area=南京&Isp=电信
http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI&OrderNumber=你的订单号&qty=5&split=json
http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI&OrderNumber=你的订单号&qty=5&ips=1
http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI&OrderNumber=你的订单号&qty=5&Area=南京&Isp=电信
http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI&OrderNumber=你的订单号&qty=5&split=json
http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI&OrderNumber=你的订单号&qty=5&ips=1
把示例里的 OrderNumber 换成你自己的订单号即可直接测试；接口是 HTTP（不要写成 https），单条循环提取很容易触发 406 限流。
返回格式
文本模式（split 留空或指定分隔符）
113.75.1.20:51008 112.84.36.17:42913
每行一条，格式为 IP:端口；账号密码模式的线路为 IP:端口:用户名:密码，把这一串直接填进爬虫的代理配置即可。
JSON 模式（split=json）
{
"status": 200,
"msg": "成功",
"QTY": 2,
"leftTime": "1天02小时",
"leftIp": "998(剩余量)",
"data": [
{
"ip": "113.75.1.20",
"port": "51008",
"city": "南京",
"isp": "电信",
"expire": "2026-09-26T09:39:53",
"outip": "",
"userName": "",
"pwd": ""
},
{
"ip": "112.84.36.17",
"port": "42913",
"city": "南京",
"isp": "电信",
"expire": "2026-09-26T09:41:20",
"outip": "",
"userName": "",
"pwd": ""
}
]
}
状态码说明
200 - 成功
正常返回；注意
QTY=0 表示本次没有可用 IP401 - 请求参数不正确
缺 OrderNumber、参数拼写错误或订单号不存在
304 - 订单已到期
订单有效期已过，续费或重新购买
204 - 套餐已过期
套餐周期结束，续费后即可继续提取
208 - 数量已用完
计量/去重计量套餐的可用量耗尽，可看
leftIp 提前预警205 - 套餐提取数量已达到上限
达到套餐提取上限，可联系客服确认能否扩量
206 - 暂无可用 IP
该城市/运营商当前资源紧张或池子正在轮换，换城市或去掉城市限制
406 - 提取频率过快
短时间大量调用，改成批量提取（
qty=10~20）并拉开间隔202 - 单次请求数量超出最大值
降低
qty，分多次提取506 - 提取数量大于单次提取最大数
线路侧限制更严格，同样降低单次数量
203 - 白名单个数限制
白名单已满，删掉不用的条目或升级套餐
207 - 提取机器超出服务范围
检查是否用代理去调接口，改用直连或把出口 IP 加入白名单
436 - 代理 IP 未经授权或已超出使用时长
重新提取一条新的 IP
504 - 代理 IP 状态异常
换一条 IP；连续出现联系客服
505 - 代理 IP 节点异常
换城市或稍后重试
完整对照表见 状态码与错误码对照表；先看 status，再按建议动作，基本不用问客服。
使用建议
-
缓存设置： 既要频繁提取又要固定出口的，用
Cache=1&Cachetimems=60000在一分钟内复用同一批 IP - 提取数量： 根据实际需要设置提取数量，避免资源浪费
- 错误处理： 请正确处理API返回的错误代码，确保程序稳定性
-
频率限制： 短时间大量调用会返回
406，建议改成批量提取（qty=10~20）再用本地小池子补货